云服务器特惠 99/年起
  1. 腾讯云优惠网首页
  2. 腾讯云产品

即时通信 IM Android&iOS&Windows&Mac（群 @ 消息）

• 腾讯云产品

群 @ 消息是指发送方监听输入栏里的输入字符，当用户输入 @ 字符后，弹出群成员选择界面。选择完需要 @ 的成员后以 “@A @B @C……” 形式显示在输入框，并可以继续编辑消息内容，完成消息发送。
接收方会在会话界面的群聊天列表，重点显示 “有人@我” 或者 “@所有人” 标识，提醒用户有人在群里 @ 自己了。

相关产品
即时通信 IM 产品页，含版本规格、价格与购买入口。

一、功能演示

监听 @ 字符选择群成员 编辑群 @ 消息发送 收到群 @ 消息
  

图一：在聊天界面监听到输入框输入 "@" 字符后，可以跳转到群成员选择界面，选择需要 @ 的群成员。
图二：在群成员选择完成后，重新返回聊天界面，继续编辑群 @ 消息发送。
图三：如果有消息 @ 我，自己会收到会话更新，可以在会话 Cell 展示 “有人@我” 信息。

二、发送群 @ 消息

1. 发送方监听聊天界面的文本输入框，启动群成员选择界面。选择完成后回传所选择的群成员 ID 和昵称信息，ID 用于构建消息对象 V2TIMMessage，昵称用于在文本框显示。

2. 发送方调用 createAtSignedGroupMessage (Java / Swift / Objective-C / C++) 接口创建一条群 @ 消息，拿到消息对象 V2TIMMessage，并在其中指定需要 @ 的成员。

3. 发送方调用 sendMessage (Java / Swift / Objective-C / C++) 将刚才创建的 @ 消息对象发送出去。

示例代码如下：

JavaSwiftObjective-CC++// 创建一条原始文本消息V2TIMMessage textMsg = V2TIMManager.getMessageManager().createTextMessage("这是一条文本消息");// 使用原始文本消息创建一条群 @ 消息，@ 群成员 "user1" 和 "user2"List<String> atUserList = new ArrayList<>();atUserList.add("user1");atUserList.add("user2");V2TIMMessage atMsg = V2TIMManager.getMessageManager().createAtSignedGroupMessage(textMsg, atUserList);// 发送群 @ 消息V2TIMManager.getMessageManager().sendMessage(atMsg, null, "toGroupID", V2TIMMessage.V2TIM_PRIORITY_DEFAULT, false, null, new V2TIMSendCallback<V2TIMMessage>() { @Override public void onError(int code, String desc) { // 群@消息发送失败 } @Override public void onSuccess(V2TIMMessage v2TIMMessage) { // 群@消息发送成功 } @Override public void onProgress(int progress) { }});// 创建一条原始文本消息if let textMsg = V2TIMManager.shared.createTextMessage(text: "这是一条文本消息") { // 使用原始文本消息创建一条群 @ 消息，@ 群成员 "xixi" 和 "yahaha" if let atMsg = V2TIMManager.shared.createAtSignedGroupMessage(message: textMsg, atUserList: ["xixi", "yahaha"]) { // 发送群 @ 消息 V2TIMManager.shared.sendMessage(message: atMsg, receiver: nil, groupID: "groupA", priority: .V2TIM_PRIORITY_NORMAL, onlineUserOnly: false, offlinePushInfo: nil, progress: nil, succ: { // 发送成功的回调 print("群 @ 消息发送成功") }, fail: { code, desc in // 发送失败的回调 print("群 @ 消息发送失败，code: \\(code), desc: \\(desc)") }) }}// 创建一条原始文本消息V2TIMMessage *textMsg = [[V2TIMManager sharedInstance] createTextMessage:@"这是一条文本消息"];// 使用原始文本消息创建一条群 @ 消息，@ 群成员 "xixi" 和 "yahaha"V2TIMMessage *atMsg = [[V2TIMManager sharedInstance] createAtSignedGroupMessage:textMsg atUserList:@[@"xixi", @"yahaha"]];// 发送群 @ 消息[[V2TIMManager sharedInstance] sendMessage:atMsg receiver:nil groupID:@"groupA" priority:V2TIM_PRIORITY_NORMAL onlineUserOnly:NO offlinePushInfo:nil progress:nil succ:nil fail:nil];class SendCallback final : public V2TIMSendCallback {public: using SuccessCallback = std::function<void(const V2TIMMessage&)>; using ErrorCallback = std::function<void(int, const V2TIMString&)>; using ProgressCallback = std::function<void(uint32_t)>; SendCallback() = default; ~SendCallback() override = default; void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback, ProgressCallback progress_callback) { success_callback_ = std::move(success_callback); error_callback_ = std::move(error_callback); progress_callback_ = std::move(progress_callback); } void OnSuccess(const V2TIMMessage& message) override { if (success_callback_) { success_callback_(message); } } void OnError(int error_code, const V2TIMString& error_message) override { if (error_callback_) { error_callback_(error_code, error_message); } } void OnProgress(uint32_t progress) override { if (progress_callback_) { progress_callback_(progress); } }private: SuccessCallback success_callback_; ErrorCallback error_callback_; ProgressCallback progress_callback_;};V2TIMStringVector atUserList;atUserList.PushBack("user1");atUserList.PushBack("user2");V2TIMMessage message = V2TIMManager::GetInstance()->GetMessageManager()->CreateTextMessage(u8"这是一条文本消息");V2TIMMessage at_message = V2TIMManager::GetInstance()->GetMessageManager()->CreateAtSignedGroupMessage(message, atUserList);auto callback = new SendCallback{};callback->SetCallback( [=](const V2TIMMessage& message) { // 群@消息发送成功 delete callback; }, [=](int error_code, const V2TIMString& error_message) { // 群@消息发送失败 delete callback; }, [=](uint32_t progress) {});V2TIMManager::GetInstance()->GetMessageManager()->SendMessage( at_message, "denny", {}, V2TIMMessagePriority::V2TIM_PRIORITY_NORMAL, false, {}, callback);

三、接收群 @ 消息

1. 在加载和更新会话处，需要调用 V2TIMConversation 的 groupAtInfolist (Java / Swift / Objective-C / C++) 接口获取会话的 @ 数据列表。

2. 通过列表中 V2TIMGroupAtInfo 对象的 atType (Java / Swift / Objective-C / C++) 接口获取 @ 数据类型，并更新到当前会话的 @ 信息。

示例代码如下：

JavaSwiftObjective-CC++//获取群@数据列表List<V2TIMGroupAtInfo> atInfoList = conversation.getGroupAtInfoList();// 解析@类型（@我，@所有人, @我且@所有人）boolean atMe = false;boolean atAll = false;String atTips = "";for(V2TIMGroupAtInfo atInfo : atInfoList){ if (atInfo.getAtType() == V2TIMGroupAtInfo.TIM_AT_ME){ atMe = true; continue; } if (atInfo.getAtType() == V2TIMGroupAtInfo.TIM_AT_ALL){ atAll = true; continue; }}// 根据@类型，提示if (atMe && !atAll) { atTips = "[有人@我]";} else if (!atMe && atAll) { atTips = "[@所有人]";} else if (atMe && atAll) { atTips = "[有人@我][@所有人]";}// 获取群@数据列表if let atInfoList = conversation.groupAtInfolist { // 解析@类型（@我，@所有人, @我且@所有人） var atMe = false // 是否@我 var atAll = false // 是否@所有人 var atTipsStr = "" // 遍历 @ 信息列表 for atInfo in atInfoList { switch atInfo.atType { case .V2TIM_AT_ME: atMe = true case .V2TIM_AT_ALL: atAll = true case .V2TIM_AT_ALL_AT_ME: atMe = true atAll = true default: break } } // 根据@类型，提示 if atMe && !atAll { atTipsStr = "[有人@我]" } else if !atMe && atAll { atTipsStr = "[@所有人]" } else if atMe && atAll { atTipsStr = "[有人@我][@所有人]" } // 输出提示信息 print(atTipsStr)}// 获取群@数据列表NSArray<V2TIMGroupAtInfo *> *atInfoList = conversation.groupAtInfolist;// 解析@类型（@我，@所有人, @我且@所有人）BOOL atMe = NO; // 是否@我BOOL atAll = NO; // 是否@所有人NSString *atTipsStr = @"";for (V2TIMGroupAtInfo *atInfo in atInfoList) { switch (atInfo.atType) { case V2TIM_AT_ME: atMe = YES; break; case V2TIM_AT_ALL: atAll = YES; break; case V2TIM_AT_ALL_AT_ME: atMe = YES; atAll = YES; break; default: break; }}// 根据@类型，提示if (atMe && !atAll) { atTipsStr = @"[有人@我]";}if (!atMe && atAll) { atTipsStr = @"[@所有人]";}if (atMe && atAll) { atTipsStr = @"[有人@我][@所有人]";}// 获取群@数据列表V2TIMGroupAtInfoVector groupAtInfolist = conversation.groupAtInfolist;// 解析@类型（@我，@所有人, @我且@所有人）bool atMe = false;bool atAll = false;std::string atTips = "";for (size_t i = 0; i < groupAtInfolist.Size(); ++i) { const V2TIMGroupAtInfo& atInfo = groupAtInfolist[i]; switch (atInfo.atType) { case V2TIM_AT_ME: atMe = true; break; case V2TIM_AT_ALL: atAll = true; break; case V2TIM_AT_ALL_AT_ME: atMe = true; atAll = true; break; default: break; }}// 根据@类型，提示if (atMe && !atAll) { atTips = u8"[有人@我]";} else if (!atMe && atAll) { atTips = u8"[@所有人]";} else if (atMe && atAll) { atTips = u8"[有人@我][@所有人]";}

相关内容：

  1. 即时通信 IM Android&iOS&Windows&Mac（插入消息） 插入消息只会将消息插入本地数据库，不会发送到服务端。该接口主要用于满足向聊天会话中插入一些提示性消息的需求，例如 “你已经退出该群”、“请注意信息安全，不要在群聊中发送任何账号、密码和验证码等私密信息”等。这类消息有展示在聊天消息区的需求，但并没有发送给其他人的必要。...
  2. 即时通信 IM Android&iOS&Windows&Mac（在线消息） 某些场景下，可以能希望发出去的消息只被对端在线时接收，当接收者不在线时不会感知到该消息。 你只需在 sendMessage 时，将参数 onlineUserOnly 设置为 true/YES，此时发送出去的消息跟普通消息相比，会有如下差异点。...
  3. 即时通信 IM Android&iOS&Windows&Mac（群定向消息） 这篇说说腾讯云IM群定向消息功能，支持向群内部分成员发送消息，仅增强版SDK 6.0.1975及以上版本支持，且仅对旗舰版或企业版客户开放，直播群不支持，定向消息不计入未读计数。 发送流程：创建原始消息对象，调用createTargetedGroupMessage指定接收成员列表，再调用sendMessage发送。 接收方式：与普通消息接收操作相同。...
  4. 即时通信 IM Android&iOS&Windows&Mac（消息置顶） 消息置顶功能是指在即时通信 App 上，将特定消息固定在列表顶部的功能，即使有新的消息进来，它也会保持在顶部。这个功能可以帮助用户更容易地找到并访问他们认为重要或频繁查看的消息。...
  5. 即时通信 IM Android（AI 聊天机器人） 该功能允许用户与 AI 机器人进行对话，实时接收机器人思考过程中的部分回复（流式输出）。2. 接收 AI 机器人流式消息的实时更新（内容追加）。...
  6. 即时通信 IM Android&iOS&Windows&Mac（消息变更） 对于会话里已经发送成功的消息，会话参与者可以对消息做二次修改，修改成功后会同步给会话的所有参与者。...
  7. 即时通信 IM Android&iOS&Windows&Mac（查询消息） 可以以先从 V2TIMMessage 消息对象中获取到 messageID，然后调用 findMessages 接口，根据 messageID 查询本地消息详情，包括状态 status 为 V2TIM_MSG_STATUS_LOCAL_REVOKED（已撤回）和 V2TIM_MSG_STATUS_HAS_DELETED（已删除）的消息。...
  8. 即时通信 IM Android&iOS&Harmony&Windows&Mac 流式消息（Stream Message）是即时通信 IM SDK 提供的一种特殊消息类型，专为 AI 对话等场景设计。在这类场景中，消息内容由服务端逐步生成，SDK 会实时接收内容分片并累加，直到整条消息生成完毕。客户端通过监听消息修改回调，即可实时获取流式消息的最新内容，实现类似 ChatGPT 的逐字输出效果。客户端还可以将流式消息的文本进行转语音处理，持续获取到 Opus 音频分片，方便用户听取消息内容。...
赞 (0)
上一篇 4天前
下一篇 4天前