音视频通话

房间自定义属性

功能介绍

房间自定义属性用于在房间维度存储业务侧需要的键值信息,例如会议主题、当前主持人、业务状态标记等。同一房间内的与会成员可共享这些字段。

本模块提供完整的生命周期能力:设置整包属性、查询全部或指定键、增量添加或更新、按键删除以及清空全部属性;各操作通过异步接口发起,结果在对应回调中返回。属性发生变更时,还可通过 notifyMeetingAttrsChanged 获知更新。

1. 设置房间属性

  • 调用接口:
HashMap<String, String> attrs = new HashMap<String, String>() {{
    put("key1", "value1");
    put("key2", "value2");
}};
HashMap<String, Object> options = new HashMap<String, Object>() {{
    put("notifyAll", 1);
}};
RTCMeeting.getInstance().setMeetingAttrs(attrs, options, "");
  • 回调通知:
@Override
void setMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie) {
    if (err != CRVIDEOSDK_ERR_DEF.CRVIDEOSDK_NOERR) {
        // 失败
    } else {
        // 成功
    }
}

相关 API 请参考:

2. 获取房间属性

  • 调用接口:
RTCMeeting.getInstance().getMeetingAllAttrs("");
  • 回调通知:
@Override
void getMeetingAllAttrsSuccess(HashMap<String, MeetingAttr> attrSeq, String cookie) {
}

@Override
void getMeetingAllAttrsFail(CRVIDEOSDK_ERR_DEF err, String cookie) {
}

相关 API 请参考:

3. 获取房间特定属性

  • 调用接口:
List<String> keys = Arrays.asList("MeetingName", "startTime", "endTime");
RTCMeeting.getInstance().getMeetingAttrs(keys, "");
  • 回调通知:
@Override
void getMeetingAttrsSuccess(HashMap<String, MeetingAttr> attrSeq, String cookie) {
}

@Override
void getMeetingAttrsFail(CRVIDEOSDK_ERR_DEF err, String cookie) {
}

相关 API 请参考:

4. 添加或更新属性

  • 调用接口:
String meetingNameKey = "MeetingName";
String meetingNameValue = "产品评审会";
RTCMeeting.getInstance().addOrUpdateMeetingAttrs(meetingNameKey, meetingNameValue, "");
  • 回调通知:
@Override
void addOrUpdateMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie) {
}

相关 API 请参考:

5. 删除房间特定属性

  • 调用接口:
String meetingName = "MeetingName";
RTCMeeting.getInstance().delMeetingAttrs(meetingName, "");
  • 回调通知:
@Override
void delMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie) {
}

相关 API 请参考:

6. 清除房间全部属性

  • 调用接口:
RTCMeeting.getInstance().clearMeetingAttrs("");
  • 回调通知:
@Override
void clearMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie) {
}

相关 API 请参考: