构建实时聊天应用程序包括线程管理、消息传递、参与者和已读回执。技能概述azure-communication-chat-java 技能提供了Azure Communication Services Chat SDK for Java的完整使用指南。该技能帮助开发者构建实时聊天应用程序支持线程管理、消息发送和接收、参与者管理、已读回执和打字通知等功能。下载地址https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-communication-chat-java主要功能聊天线程管理: 创建、删除和管理聊天线程消息操作: 发送、接收、更新和删除消息参与者管理: 添加、删除和列出聊天参与者已读回执: 发送和跟踪消息已读状态打字通知: 发送打字指示器异步客户端: 支持异步操作提高性能触发条件在以下情况下应该调用此技能:需要构建Java聊天应用程序实现实时消息传递功能管理聊天线程和参与者实现已读回执和打字通知使用Azure Communication Services进行聊天开发核心概念类用途ChatClient创建/删除聊天线程获取线程客户端ChatThreadClient线程内操作消息、参与者、回执ChatParticipant聊天线程中的用户及显示名称ChatMessage消息内容、类型、发送者信息、时间戳ChatMessageReadReceipt每个参与者的已读回执跟踪安装方法dependency groupIdcom.azure/groupId artifactIdazure-communication-chat/artifactId version1.6.0/version /dependency使用示例示例1: 创建客户端import com.azure.communication.chat.ChatClient;import com.azure.communication.chat.ChatClientBuilder;import com.azure.communication.common.CommunicationTokenCredential;String endpoint https://resource.communication.azure.com;String userAccessToken user-access-token;CommunicationTokenCredential credential new CommunicationTokenCredential(userAccessToken);ChatClient chatClient new ChatClientBuilder().endpoint(endpoint).credential(credential).buildClient();示例2: 创建聊天线程import com.azure.communication.chat.models.*;import com.azure.communication.common.CommunicationUserIdentifier;import java.util.ArrayList;import java.util.List;ListChatParticipant participants new ArrayList();ChatParticipant participant1 new ChatParticipant().setCommunicationIdentifier(new CommunicationUserIdentifier(user-id-1)).setDisplayName(Alice);ChatParticipant participant2 new ChatParticipant().setCommunicationIdentifier(new CommunicationUserIdentifier(user-id-2)).setDisplayName(Bob);participants.add(participant1);participants.add(participant2);CreateChatThreadOptions options new CreateChatThreadOptions(Project Discussion).setParticipants(participants);CreateChatThreadResult result chatClient.createChatThread(options);String threadId result.getChatThread().getId();ChatThreadClient threadClient chatClient.getChatThreadClient(threadId);示例3: 发送和接收消息// 发送文本消息SendChatMessageOptions messageOptions new SendChatMessageOptions().setContent(Hello, team!).setSenderDisplayName(Alice).setType(ChatMessageType.TEXT);SendChatMessageResult sendResult threadClient.sendMessage(messageOptions);String messageId sendResult.getId();// 列出所有消息PagedIterableChatMessage messages threadClient.listMessages();for (ChatMessage message : messages) {System.out.println(ID: message.getId());System.out.println(Content: message.getContent().getMessage());System.out.println(Sender: message.getSenderDisplayName());}示例4: 管理参与者// 列出参与者PagedIterableChatParticipant participants threadClient.listParticipants();for (ChatParticipant participant : participants) {CommunicationUserIdentifier user (CommunicationUserIdentifier) participant.getCommunicationIdentifier();System.out.println(User: user.getId());System.out.println(Display Name: participant.getDisplayName());}// 添加参与者ListChatParticipant newParticipants new ArrayList();newParticipants.add(new ChatParticipant().setCommunicationIdentifier(new CommunicationUserIdentifier(new-user-id)).setDisplayName(Charlie).setShareHistoryTime(OffsetDateTime.now().minusDays(7)));threadClient.addParticipants(newParticipants);// 删除参与者CommunicationUserIdentifier userToRemove new CommunicationUserIdentifier(user-id);threadClient.removeParticipant(userToRemove);示例5: 已读回执// 发送已读回执threadClient.sendReadReceipt(messageId);// 获取已读回执PagedIterableChatMessageReadReceipt receipts threadClient.listReadReceipts();for (ChatMessageReadReceipt receipt : receipts) {System.out.println(Message ID: receipt.getChatMessageId());System.out.println(Read by: receipt.getSenderCommunicationIdentifier());System.out.println(Read at: receipt.getReadOn());}消息类型类型描述TEXT常规聊天消息HTMLHTML格式消息TOPIC_UPDATED系统消息 - 主题已更改PARTICIPANT_ADDED系统消息 - 参与者已加入PARTICIPANT_REMOVED系统消息 - 参与者已离开最佳实践令牌管理: 用户令牌会过期使用CommunicationTokenRefreshOptions实现刷新逻辑分页: 对大型线程使用带maxPageSize的listMessages(options)共享历史: 添加参与者时设置shareHistoryTime控制消息可见性消息类型: 从用户消息中过滤系统消息PARTICIPANT_ADDED等已读回执: 仅在用户实际查看消息时发送回执环境变量AZURE_COMMUNICATION_ENDPOINThttps://resource.communication.azure.com AZURE_COMMUNICATION_USER_TOKENuser-access-token限制说明仅当任务明确符合上述范围时使用此技能不要将输出视为环境特定验证、测试或专家审查的替代品如果缺少所需的输入、权限、安全边界或成功标准请停止并寻求澄清