Google Cast接收器无法被Android应用发现的技术问询

针对你的疑问逐一解答： #

1. 应用是否必须发布才能正常发现设备？ #

不需要。未发布的Cast应用只要将目标接收器设备添加到开发者控制台的白名单中，即可在该设备上测试。但需确认：

• 设备序列号输入完全正确（注意大小写、无多余空格）
• 白名单绑定的是你当前使用的App ID
• 设备在添加白名单后已完成重启（你已做过，可忽略）

2. 发送端针对Styled Media Receiver的特殊配置 #

使用自定义Styled Media Receiver时，发送端需注意以下配置：

• 必须使用控制台生成的专属App ID：不能使用默认媒体接收器的CC1AD845，否则设备无法识别你的自定义接收器配置
• 配置CastOptions指定App ID：在代码中通过CastOptionsProvider或直接构建CastOptions时明确设置你的App ID，示例代码：

CastOptions castOptions = new CastOptions.Builder()
    .setReceiverApplicationId("<你的自定义App ID>")
    .build();
CastContext.getSharedInstance(context).setCastOptions(castOptions);

• 确保Intent to Join URI可访问：接收器设备需能正常加载你配置的URI地址，该地址需返回符合Cast规范的接收器页面

3. 问题是否与Intent to Join URI或App ID相关？ #

大概率相关：

• App ID错误：如果混用默认ID和自定义Receiver的ID，设备会因为无法匹配接收器配置而不被发现
• Intent to Join URI无效：若该URI无法访问或不符合Cast接收器规范，设备加载接收器失败，可能会从发现列表中隐藏
• 白名单与App ID不绑定：检查控制台中，你的设备白名单是否关联了当前使用的App ID

4. 额外排查步骤 #

• 启用Cast调试日志：通过adb命令开启日志，查看设备发现过程中的错误信息：

adb shell setprop log.tag.Cast VERBOSE
adb shell setprop log.tag.CastApi VERBOSE
adb logcat -s Cast CastApi

• 测试默认接收器：临时将App ID切换为CC1AD845，若能发现设备，说明问题出在自定义Styled Receiver的配置上
• 检查网络环境：
  • 确认路由器未开启AP隔离功能
  • 确保UDP 5353端口（mDNS协议端口）未被防火墙屏蔽
  • 发送端和接收器需连接同一Wi-Fi的2.4G或5G频段（部分设备跨频段无法发现）
• 更新系统与SDK：
  • 将Google TV设备更新至最新系统版本
  • 确认发送端使用的Google Cast SDK为最新稳定版
• 验证白名单状态：登录Cast开发者控制台，确认设备状态为"已添加"，且未被移除
• 清除应用缓存：卸载并重新安装发送端应用，或清除应用缓存后重试
• 使用Cast验证工具：通过Google提供的Cast Validator检查你的接收器页面是否符合规范

内容的提问来源于stack exchange，提问作者Laxmi Kant