iOS音频App AirPlay到tvOS无Now Playing控件问题排查

你的App和Spotify在tvOS端AirPlay Now Playing表现的差异，核心原因集中在音频会话管理、元数据推送时机/完整性、远程命令支持这几个维度，具体如下：

1. MPNowPlayingInfoCenter元数据的推送逻辑问题 #

Spotify在AirPlay路由切换时，会主动向tvOS推送完整且及时的元数据，包括标题、艺术家、适配tvOS分辨率的专辑封面，并且会在会话建立前后多次同步这些信息。而你的App可能仅在本地播放时更新元数据，AirPlay切换时没有触发重新同步，或者元数据字段不全：

• 缺少MPMediaItemPropertyArtwork的正确配置（比如用了不兼容tvOS的低分辨率图片，或没有使用MPMediaItemArtwork的requestHandler提供适配尺寸的图片）；
• 未包含MPMediaItemPropertyTitle、MPMediaItemPropertyArtist这类必填核心字段。

2. AVAudioSession路由变化的处理缺失 #

当AirPlay路由切换到Apple TV时，你的App可能没有监听AVAudioSession.routeChangeNotification并做出响应：

• 没有在路由切换后重新激活音频会话（调用setActive(true, options: .notifyOthersOnDeactivation)）；
• 没有在路由变更后强制更新Now Playing信息，导致tvOS没有收到元数据触发信号。

3. MPRemoteCommandCenter的命令支持不完整 #

tvOS的Now Playing控件需要App支持完整的远程命令集，Spotify实现了所有必要命令（包括进度调整、播放/暂停、上下曲等），而你的App可能仅注册了部分命令：

• 未启用changePlaybackPositionCommand（进度条控制）；
• 部分命令的isEnabled属性未设置为true，导致tvOS认为App不支持完整控制，从而不显示控件。

4. AirPlay会话的状态触发逻辑差异 #

直接从你的App发起AirPlay时，tvOS可能没有收到足够的播放状态变更信号来启动Now Playing界面。而先播放Spotify再切换时，tvOS已处于音频元数据监听状态，此时你的App的元数据会被直接识别。这种情况通常是因为你的App在AirPlay会话建立后，没有主动触发一次播放状态的变更（比如从暂停切换到播放，即使实际是持续播放）。

排查步骤 #

• 检查元数据完整性：确保nowPlayingInfo包含所有核心字段，其中MPMediaItemArtwork需用requestHandler提供适配tvOS的高清图片：

  let artwork = MPMediaItemArtwork(boundsSize: CGSize(width: 1024, height: 1024)) { size in
      return yourHighResImage.resized(to: size)
  }
  MPNowPlayingInfoCenter.default().nowPlayingInfo = [
      MPMediaItemPropertyTitle: "歌曲标题",
      MPMediaItemPropertyArtist: "艺术家",
      MPMediaItemPropertyArtwork: artwork
  ]
  

• 监听路由变化并同步状态：注册AVAudioSession.routeChangeNotification，在回调中重新激活会话并更新元数据：

  NotificationCenter.default.addObserver(self, selector: #selector(handleRouteChange(_:)), name: AVAudioSession.routeChangeNotification, object: nil)
  
  @objc func handleRouteChange(_ notification: Notification) {
      guard let userInfo = notification.userInfo,
            let reasonValue = userInfo[AVAudioSessionRouteChangeReasonKey] as? UInt,
            let reason = AVAudioSession.RouteChangeReason(rawValue: reasonValue) else { return }
      
      if reason == .newDeviceAvailable {
          // AirPlay路由已连接，重新激活会话并更新元数据
          try? AVAudioSession.sharedInstance().setActive(true)
          updateNowPlayingInfo() // 自定义更新元数据的方法
      }
  }
  

• 完善远程命令支持：确保所有必要命令都已注册并启用：

  let commandCenter = MPRemoteCommandCenter.shared()
  commandCenter.playCommand.isEnabled = true
  commandCenter.pauseCommand.isEnabled = true
  commandCenter.nextTrackCommand.isEnabled = true
  commandCenter.previousTrackCommand.isEnabled = true
  commandCenter.changePlaybackPositionCommand.isEnabled = true
  // 为每个命令添加处理回调
  

• 主动触发状态变更：在AirPlay会话建立后，主动触发一次播放状态切换（比如先暂停再播放），强制tvOS识别元数据。

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