跳到主要内容

聊天室销毁机制

聊天室业务支持通过多种方式灵活控制聊天室的销毁条件与存活时长。

聊天室自动销毁机制

聊天室具有自动销毁机制。如果创建聊天室时未配置自动销毁类型、且后续未通过 API 设置自动销毁类型,则默认自动销毁类型为不活跃后自动销毁。聊天室会在不活跃达到 1 小时后踢出所有成员,并自动销毁(“不活跃”是指连续时间段内无成员进出且无新消息产生)。

您可以从控制台修改 App Key 级别默认设置,调整聊天室不活跃时长达到多少小时后应被自动销毁。自助配置最大支持配置为 24 小时。详见调整聊天室销毁等待时间

一旦在调用 API 创建聊天室时配置了自动销毁类型,无论是否通过 API 设置销毁时间,均以 API 级别配置为准(包括默认值),App Key 级别的配置不生效。

设置自动销毁类型

您可以在创建聊天室时,可通过参数配置是否定时销毁该聊天室,或在不活跃时销毁该聊天室。

  • 如果设置为不活跃后销毁,可通过 destroyTime 参数传入聊天室不活跃时长(分钟),控制连续不活跃(无人进出且无新消息产生)达到多久时应被自动销毁。
  • 如果设置定时自动销毁,可通过 destroyTime 参数配置存活时长(分钟),存活时长自聊天室创建后开始计算。采用此销毁类型的聊天室最长存活 10800 分钟(7 天)。

在聊天室创建以后,您可以通过设置聊天室销毁类型 修改指定聊天室的自动销毁类型。

聊天室不被自动销毁的情况

  • 绑定音视频房间: 聊天室与音视频房间绑定成功后,当聊天室达到预设的自动销毁条件时,服务端会先检测已绑定的音视频房间(RTCRoomId)是否仍存在。如果绑定的音视频房间仍存在,则则阻止聊天室自动销毁。如果绑定的音视频房间已销毁,则直接销毁聊天室。
  • 保活聊天室:只要聊天室已被保活,就可确保聊天室不被自动销毁。保活状态下的聊天室只能通过调用销毁聊天室 API 接口销毁。