用户自定义属性
功能介绍
支持对房间内指定成员的自定义属性进行增删改查,可用于展示角色、部门等业务信息。
注意:成功进入房间后,才可以操作用户属性。
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 请参考: