音视频通话

用户自定义属性

功能介绍

支持对房间内指定成员的自定义属性进行增删改查,可用于展示角色、部门等业务信息。

注意:成功进入房间后,才可以操作用户属性。

1. 设置成员属性

  • 调用接口:
string userId = "111";
string attrs = "{\"name\":\"Bob\",\"companyName\":\"ABC\"}";
g_sdkMain.getSDKMeeting().setUserAttrs(userId, attrs, "", "");
  • 回调通知:
private void setUserAttrsRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    if (CRVSDK_ERR_DEF.CRVSDKERR_NOERR != sdkErr)
    {
        // 失败
    }
    else
    {
        // 成功
    }
}

相关 API 请参考:

2. 获取指定成员属性

  • 调用接口:
string userIDs = "[\"111\", \"222\"]";
g_sdkMain.getSDKMeeting().getUserAttrs(userIDs, "", "");
  • 回调通知:
private void getUserAttrsFail(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    // 获取失败
}

private void getUserAttrsSuccess(string attrsMap, string cookie)
{
    // 获取成功
}

相关 API 请参考:

3. 获取指定成员指定属性

  • 调用接口:
string userIDs = "[\"111\", \"222\"]";
string keys = "[\"name\", \"companyName\"]";
g_sdkMain.getSDKMeeting().getUserAttrs(userIDs, keys, "");

相关 API 请参考:

4. 添加或更新成员属性

  • 调用接口:
string userId = "111";
string attrs = "{\"department\":\"R&D\",\"companyName\":\"ABC\"}";
g_sdkMain.getSDKMeeting().addOrUpdateUserAttrs(userId, attrs, "", "");
  • 回调通知:
private void addOrUpdateUserAttrsRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    if (CRVSDK_ERR_DEF.CRVSDKERR_NOERR != sdkErr)
    {
        // 失败
    }
    else
    {
        // 成功
    }
}

相关 API 请参考:

5. 删除成员指定属性

  • 调用接口:
string userId = "111";
string keys = "[\"department\", \"companyName\"]";
g_sdkMain.getSDKMeeting().delUserAttrs(userId, keys, "", "");
  • 回调通知:
private void delUserAttrsRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    if (CRVSDK_ERR_DEF.CRVSDKERR_NOERR != sdkErr)
    {
        // 失败
    }
    else
    {
        // 成功
    }
}

相关 API 请参考:

6. 清除指定成员全部属性

  • 调用接口:
string userId = "111";
g_sdkMain.getSDKMeeting().clearUserAttrs(userId, "", "");
  • 回调通知:
private void clearUserAttrsRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    if (CRVSDK_ERR_DEF.CRVSDKERR_NOERR != sdkErr)
    {
        // 失败
    }
    else
    {
        // 成功
    }
}

相关 API 请参考:

7. 清除房间内所有成员属性

  • 调用接口:
g_sdkMain.getSDKMeeting().clearAllUserAttrs("", "");
  • 回调通知:
private void clearAllUserAttrsRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    if (CRVSDK_ERR_DEF.CRVSDKERR_NOERR != sdkErr)
    {
        // 失败
    }
    else
    {
        // 成功
    }
}

8. 属性变化通知

成员属性被修改时,房间内所有人会收到通知:

private void notifyUserAttrsChanged(string userID, string attrs)
{
    // 刷新该成员在 UI 上的展示信息
}

相关 API 请参考: