自定义房间属性
房间数据存储
- 向房间内设置数据时不区分成员,若多人设置相同的
key
会相互覆盖。- 以下示例代码中的
room
指加入房间成功后获取到的实例。
房间属性变化通知
加入房间成功后,可以通过调用 room.registerRoomEventListener()
注册 onRoomAttributeChange
事件监听器。
当房间内成员对属性进行修改、删除,且选择发送通知时,注册的回调函数会被调用。
设置房间属性
// 设置房间属性,不发送通知
const { code } = await room.setRoomAttribute(key, value)
// 设置房间属性,并发送通知
const { code } = await room.setRoomAttribute(key, value, { name: '', content: '' })
获取房间属性
// 获取房间属性,支持同时获取多个属性
const { code, data } = await room.getRoomAttributes(['key_1', 'key2'])
// 当获取失败时,data 值为 undefined
if (code !== RCRTCCode.SUCCESS) {
console.error('房间属性获取失败:', code)
return
}
// 获取到的值以 `key-value` 键值对的方式挂载于 data 数据中
const data_1 = data['key_1']
const data_2 = data['key_2']
删除房间属性
// 删除房间属性,不发送通知
const { code } = await room.deleteRoomAttributes(['key_1', 'key_2'])
// 删除房间属性,并发送通知
const { code } = await room.deleteRoomAttributes(['key_1', 'key_2'], { name: '', content: '' })