CAF框架队列JPEG图片播放异常：仅显示单张图片求助

我之前在做CAF接收器的图片队列播放时，也碰到过一模一样的问题——明明传了多个QueueItem，接收器却只停留在startIndex指定的那张图上。结合官方文档和调试踩过的坑，给你几个关键的排查点和解决方案：

1. 确保QueueItem的媒体类型和时长配置正确 #

CAF对静态图片的媒体类型校验很严格，而且必须显式设置显示时长，否则接收器不知道什么时候切换到下一张：

• 每个QueueItem的media.contentType必须设为image/jpeg（不能缺省或设成image/*这类通配符）
• 一定要给media.duration赋值（单位：秒），比如设置为5表示每张图显示5秒

示例代码片段：

const queueItems = [
  {
    media: {
      contentId: 'https://your-domain.com/image1.jpg',
      contentType: 'image/jpeg',
      duration: 6 // 自定义每张图的显示时长
    },
    title: 'First Image'
  },
  // 其他图片QueueItem同理...
];

2. 检查LoadRequestData的核心配置 #

发送加载请求时，必须确保启用自动播放并正确关联队列数据：

• autoplay要设为true，否则队列只会加载但不会自动播放
• queueData里的items要正确指向你的QueueItem数组，startIndex要在数组索引范围内（比如从0开始）
• 如果需要循环播放，可以设置repeatMode为cast.framework.messages.RepeatMode.ALL

完整的LoadRequestData构建示例：

const loadRequestData = new cast.framework.messages.LoadRequestData({
  autoplay: true,
  queueData: new cast.framework.messages.QueueData({
    items: queueItems,
    startIndex: 0,
    repeatMode: cast.framework.messages.RepeatMode.ALL // 可选，开启队列循环
  })
});

// 发送请求到接收器
cast.framework.CastContext.getInstance()
  .getCurrentSession()
  .loadMedia(loadRequestData);

3. 排查接收器端的队列行为 #

有时候接收器应用的自定义逻辑会干扰默认队列播放：

• 确保接收器代码里没有覆盖QUEUE_LOAD事件的默认处理，比如不要在cast.framework.CastReceiverContext.getInstance().addEventListener里做阻止队列推进的操作
• 确认接收器初始化代码正确调用了cast.framework.CastReceiverContext.getInstance().start()，没有遗漏核心初始化步骤

4. 用调试工具定位问题 #

推荐用Chrome的Cast调试工具（chrome://cast/#debug）：

• 查看接收器的日志输出，搜索queue相关的错误信息，比如是否有媒体加载失败、队列项无效的提示
• 在发送请求后，通过调试工具的控制台调用cast.framework.RemotePlayer.getInstance().getQueueItems()，确认队列是否被正确加载到接收器端

按照上面的步骤排查后，应该就能让队列自动逐个播放图片了。

内容的提问来源于stack exchange，提问作者Amit Ray