音视频通话

房间自定义属性

功能介绍

支持对房间内自定义属性进行增删改查,可用于同步会议主题、业务状态等信息。

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

1. 设置房间属性

  • 调用接口:
// 即将设置的属性(JSON 字符串)
string meetAttrs = "{\"MeetingName\":\"xxx\",\"departmentName\":\"xxx\"}";
g_sdkMain.getSDKMeeting().setMeetingAttrs(meetAttrs, "", "");
  • 回调通知:
// 设置房间属性结果
private void setMeetingAttrsRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    if (CRVSDK_ERR_DEF.CRVSDKERR_NOERR != sdkErr)
    {
        // 失败
    }
    else
    {
        // 成功
    }
}

相关 API 请参考:

2. 获取房间全部属性

  • 调用接口:
g_sdkMain.getSDKMeeting().getMeetingAllAttrs("");
  • 回调通知:
private void getMeetingAllAttrsSuccess(string attrs, string cookie)
{
    // 获取成功
}

private void getMeetingAllAttrsFail(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    // 获取失败
}

相关 API 请参考:

3. 获取房间指定属性

  • 调用接口:
string keys = "[\"MeetingName\", \"CompanyName\"]";
g_sdkMain.getSDKMeeting().getMeetingAttrs(keys, "");
  • 回调通知:
private void getMeetingAttrsSuccess(string attrs, string cookie)
{
    // 获取成功
}

private void getMeetingAttrsFail(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    // 获取失败
}

相关 API 请参考:

4. 添加或更新属性

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

相关 API 请参考:

5. 删除房间指定属性

  • 调用接口:
string meetAttrs = "[\"MeetingName\", \"CompanyName\"]";
g_sdkMain.getSDKMeeting().delMeetingAttrs(meetAttrs, "", "");
  • 回调通知:
private void delMeetingAttrsRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
    if (CRVSDK_ERR_DEF.CRVSDKERR_NOERR != sdkErr)
    {
        // 失败
    }
    else
    {
        // 成功
    }
}

相关 API 请参考:

6. 清除房间全部属性

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

7. 属性变化通知

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

private void notifyMeetingAttrsChanged(string attrs)
{
    // attrs 为变更后的属性 JSON,可据此刷新 UI
}

相关 API 请参考: