Android TV Cast发送者数量限制：如何设置仅允许同时1个用户连接？

核心实现逻辑（标准方式） #

限制一次仅1个发送者的标准做法是由Receiver端作为主控方管理会话，这是Cast框架推荐的中心化控制模式，能避免多Sender状态不一致的问题：

• 在Receiver的onSessionStarted回调中，维护一个全局变量记录当前活跃的会话ID/Sender ID；
• 当检测到新Sender发起连接时，直接调用CastReceiverContext.getInstance().getSessionManager().endSession(currentSessionId, EndReason.REPLACED_BY_NEW_SESSION)强制终止旧会话；
• 在onSessionEnded回调中，清空记录的活跃会话标识，确保新会话能正常初始化。

为什么选择Receiver断开旧会话 #

• Receiver是Cast会话的中心控制点，所有Sender的连接状态都由其统一维护，能保证状态同步的可靠性；
• 若由Sender自行断开，可能因网络延迟、Sender未正确处理指令等原因导致旧会话残留，进而引发元数据展示异常。

解决旧Sender元数据在新Sender可见的问题 #

你遇到的元数据残留问题，本质是旧Sender的Cast SDK缓存了会话数据，即使Receiver终止会话，Sender端未及时刷新状态。可以通过以下步骤解决：

• Receiver端：在终止旧会话前，通过自定义消息通道向旧Sender发送"会话已被替换"的指令；
• Sender端：监听该自定义消息，收到后调用CastContext.getInstance().getSessionManager().endCurrentSession(true)，同时重置本地元数据展示逻辑（比如清空播放队列、隐藏Cast控制UI）；
• 确保Sender端实现SessionManagerListener的onSessionEnded回调，在回调中同步清理本地缓存的元数据，避免残留展示。

内容的提问来源于stack exchange，提问作者Gor Grigoryan