• UIKit
  • SDK
  • サーバー API
Chat/
SDK/
Unity(Game Solution)/
セッション/
SDK
  • Run Demo
  • SDK の統合
  • 初期化
  • ログインとログアウト
  • メッセージ
    • メッセージの概要
    • メッセージ送信
    • メッセージの受信
    • 過去のメッセージ
    • メッセージ転送
    • メッセージの変更
    • メッセージ削除
    • メッセージをクリア
    • メッセージの取り消し
    • オンラインメッセージ
    • 既読レシート
    • クエリーメッセージ
    • グループ @ メッセージ
    • ターゲットグループメッセージ
    • 通知のサイレントモード
    • メッセージ拡張
  • セッション
    • セッションの概要
    • セッションリスト
    • セッションの取得
    • 未読セッション数
    • セッションの先頭固定表示
    • セッションの削除
    • セッションの下書き
    • セッションフラグ
    • セッショングループ
  • グループ
    • グループの概要
    • グループ管理
    • グループプロファイル
    • グループメンバーの管理
    • グループメンバープロファイル
    • グループプロパティのカスタマイズ
    • グループカウンター
  • ユーザー
    • ユーザープロファイル
    • ユーザー状態
    • 友達管理
    • 友達リスト
    • ブラックリスト
  • Changelog
  • Guideline for Beginners
  • コンソールガイド
    • アプリケーションの作成とアップグレード
    • 基本設定
    • 機能設定
    • アカウント管理
    • グループ管理
    • コールバック設定
  • 製品紹介
    • メッセージ管理
      • シングルチャットメッセージ
      • メッセージの保存
      • オフラインプッシュ
      • グループメッセージ
      • メッセージフォーマット
    • アカウントシステム
      • ログイン認証
      • オンライン状態管理
    • グループ関連
      • グループシステム
      • グループ管理
    • ユーザープロファイルとリレーションシップチェーン
      • 資料管理
      • リレーションシップチェーン管理
  • 購入ガイド
    • 課金の概要
    • 価格
  • エラーコード
このページは現在英語版のみで提供されており、日本語版も近日中に提供される予定です。ご利用いただきありがとうございます。

セッショングループ

Overview

In some cases, you may need to group conversations, for example, into a "Product experience" or "R&D" group, which can be implemented through the following API.
Note
To use this feature, you need to purchase the Premium edition.
This feature is supported only on the enhanced edition on native SDK 6.5 or later.

Conversation Group

Creating a conversation group

Call the ConvCreateConversationGroup (details) API to create a conversation group.
Note
Up to 20 conversation groups can be created. After this limit is exceeded, the 51010 error will be reported. Groups that are no longer used should be promptly deleted.
Attribute
Definition
Description
groupName
Conversation group name
It must be greater than 0 in length and can contain up to 32 bytes; otherwise, the 51011 error will be reported.
conversationIDList
List of conversation IDs
It cannot be empty.
Sample code:
// Create a conversation group
TIMResult res = TencentIMSDK.ConvCreateConversationGroup("groupName", new List<string> {
conv_id
}, (int code, string desc, List<ConversationOperationResult> results, string user_data)=>{
// Async result of the conversation group creation
});

Deleting a conversation group

Call the ConvDeleteConversationGroup (details) API to delete a conversation group.
Note
If the target conversation group doesn't exist, the 51009 error will be reported.
Sample code:
// Delete the conversation group
TIMResult res = TencentIMSDK.ConvDeleteConversationGroup("groupName", (int code, string desc, string result, string user_data)=>{
// Async result of the conversation group deletion
});

Renaming a conversation group

Call the ConvRenameConversationGroup (details) API to rename a conversation group.
Sample code:
// Rename a conversation group
TIMResult res = TencentIMSDK.ConvRenameConversationGroup("oldGroupName", "newGroupName", (int code, string desc, string result, string user_data)=>{
// Async result of the conversation group renaming
});

Getting the list of conversation groups

Call the ConvGetConversationGroupList (details) API to get the list of conversation groups.
Sample code:
// Get the list of conversation groups
TIMResult res = TencentIMSDK.ConvGetConversationGroupList((int code, string desc, List<string> results, string user_data)=>{
// Async result of the conversation group list getting
});
To get the list of conversations under a group, you can call the ConvGetConversationListByFilter (details) API.
Sample code:
// Get the conversation list
ConversationListFilter filter = new ConversationListFilter
{
conversation_list_filter_conv_type: TIMConvType.kTIMConv_C2C,// Conversation type
conversation_list_filter_mark_type: TIMConversationMarkType.kTIMConversationMarkTypeStar,// Conversation mark type
conversation_list_filter_conversation_group: "groupName"// Named of the group whose data is to be pulled
};
ulong next_seq = 0; // Pulling cursor
uint count = 10; // Pulling count
// Advanced API for getting the conversation list
TIMResult res = TencentIMSDK.ConvGetConversationListByFilter(filter, next_seq, count, (int code, string desc, ConversationListResult result, string user_data)=>{
// Async result of the conversation list getting
if (code == 0) {
// Pulled successfully
bool isFinished = result.conversation_list_result_is_finished; // Whether pulling is completed
next_seq = result.conversation_list_result_next_seq; // Cursor for subsequent paged pulling
var conversationList = result.conversation_list_result_conv_list; // List of messages pulled this time
// If more conversations need to be pulled, use the returned `nextSeq` to continue pulling until `isFinished` is `true`.
}
});

Adding a conversation to a group

After a group is created, you can call the ConvAddConversationsToGroup (details) API to add a conversation to the group.
Sample code:
// Add a conversation to a conversation group
TIMResult res = TencentIMSDK.ConvAddConversationsToGroup("groupName", new List<string> {
conv_id
}, (int code, string desc, List<ConversationOperationResult> results, string user_data)=>{
// Async result of adding a conversation to a conversation group
});

Deleting a conversation from a group

Call the ConvDeleteConversationsFromGroup (details) API to delete a conversation from a group.
Sample code:
// Delete a conversation from a conversation group
TIMResult res = TencentIMSDK.ConvDeleteConversationsFromGroup("groupName", new List<string> {
conv_id
}, (int code, string desc, List<ConversationOperationResult> results, string user_data)=>{
// Async result of deleting a conversation from a conversation group
});

Listening for the notification of a conversation group change

Call the SetConvEventCallback (details) API to listen for conversation group change notifications.
Sample code:
// Set the conversation listener
TencentIMSDK.SetConvEventCallback((TIMConvEvent conv_event, List<ConvInfo> conv_list, string user_data)=>{
// Process the callback logic
});