グループメンバーの検索
機能説明
グループメンバー検索は、ローカルに保存されたことのあるグループメンバーだけを検索できます。例えば、取得したことのあるグループメンバーリスト、取得したことのあるグループメンバープロフィールなど。
説明:
flutter sdk 3.8.0ではサポートされる。ライブストリーミンググループ(AVChatRoom)はローカルにグループメンバーを保存しないため、グループメンバー検索機能を使用できません。
ローカルグループ検索
searchGroupMembers
(詳細はこちら)インターフェースを呼び出してローカルグループメンバーを検索できます。
検索キーワードkeywordList
を設定し、検索範囲を指定できます。つまり、memberUserID
、memberNickName
、memberRemark
、memberNameCard
フィールドを検索するかを指定できます。searchGroupMembers
に渡したパラメータV2TIMGroupMemberSearchParam
(詳細はこちら)におけるgroupIDList
が空(null
/nil
)かによって、以下の処理が実行されます:groupIDListが空の場合、すべてのグループのグループメンバーを検索します。返された検索結果はgroupIDで分類されます。
groupIDListが空でない場合、指定したグループのグループメンバーを検索します。
サンプルコードは以下の通りです:
//検索パラメータを設定するV2TimGroupMemberSearchParam param = V2TimGroupMemberSearchParam(groupIDList: [],// グループIDリストを指定する。nullの場合、すべてのグループのグループメンバーを検索するisSearchMemberNameCard: True,// グループメンバーの名刺を検索するかを設定する。デフォルトではtrueとするisSearchMemberRemark: true,// グループメンバーの備考を検索するかを設定する。デフォルトではtrueとするisSearchMemberNickName: true,// グループメンバーのニックネームを検索するかを設定する。デフォルトではtrueとするisSearchMemberUserID: true,// グループメンバーのuserIDを検索するかを設定する。デフォルトではtrueとするkeywordList: []);// キーワードリストを検索する。最大5つまで検索可能//グループメンバーを検索するV2TimValueCallback<V2GroupMemberInfoSearchResult> searchGroupMembersRes =await TencentImSDKPlugin.v2TIMManager.getGroupManager().searchGroupMembers(param: param); // グループメンバーの検索パラメータを検索するif (searchGroupMembersRes.code == 0) {// 検索成功searchGroupMembersRes.data?.groupMemberSearchResultItems;// グループメンバーの検索結果}