グループメンバーの検索
機能説明
グループメンバー検索は、ローカルに保存されたことのあるグループメンバーだけを検索できます。例えば、取得したことのあるグループメンバーリスト、取得したことのあるグループメンバープロフィールなど。
説明:
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;// グループメンバーの検索結果}