Android TV应用因Now Playing卡片问题遭拒，点击按钮无响应求助

• 修正PendingIntent的Flag适配API31+
  API 31及以上版本强制要求PendingIntent指定FLAG_IMMUTABLE或FLAG_MUTABLE，谷歌官方示例代码可能未针对Android TV场景更新此配置，导致点击卡片时Intent无法正确解析。根据业务需求选择合适的Flag：

  • 若无需修改Intent的额外数据，使用FLAG_IMMUTABLE（推荐）
  • 若需要动态更新Intent内容，使用FLAG_MUTABLE
    示例代码：

  val nowPlayingIntent = Intent(context, NowPlayingActivity::class.java).apply {
      flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP
      putExtra("media_id", currentMediaId) // 传递必要参数
  }
  
  val pendingIntent = PendingIntent.getActivity(
      context,
      0,
      nowPlayingIntent,
      PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
  )
  
  mediaSession.setSessionActivity(pendingIntent)
  

• 明确指定Intent的目标组件与Action
  Android TV的系统启动逻辑对Intent匹配要求更严格，避免依赖隐式Intent匹配。确保Intent直接指定目标Activity，并在Manifest中配置对应的intent-filter：

  1. 构建Intent时指定Activity类：

  val nowPlayingIntent = Intent(context, NowPlayingActivity::class.java).apply {
      action = "com.your.app.action.OPEN_NOW_PLAYING"
      flags = Intent.FLAG_ACTIVITY_NEW_TASK
  }
  

  2. 在Manifest中为NowPlayingActivity添加intent-filter：

  <activity android:name=".NowPlayingActivity">
      <intent-filter>
          <action android:name="com.your.app.action.OPEN_NOW_PLAYING" />
          <category android:name="android.intent.category.DEFAULT" />
      </intent-filter>
  </activity>
  

• 调整Activity的LaunchMode适配TV场景
  Android TV的任务栈管理逻辑与手机端不同，设置合适的launchMode避免页面无法正常唤起：

  <activity
      android:name=".NowPlayingActivity"
      android:launchMode="singleTop"
      android:exported="true"> <!-- 确保Activity可被系统唤起 -->
  </activity>
  

  注意：API31+要求可被外部唤起的Activity显式设置android:exported="true"，否则系统无法启动该Activity。

• 验证MediaSession状态完整性
  系统仅会在MediaSession的PlaybackState和Metadata设置完整时，正确关联Now Playing卡片与PendingIntent。确保播放状态设置为STATE_PLAYING，且Metadata包含必要字段（如标题、艺术家）：

  val playbackState = PlaybackStateCompat.Builder()
      .setState(PlaybackStateCompat.STATE_PLAYING, currentPosition, 1.0f)
      .build()
  mediaSession.setPlaybackState(playbackState)
  
  val metadata = MediaMetadataCompat.Builder()
      .putString(MediaMetadataCompat.METADATA_KEY_TITLE, mediaTitle)
      .putString(MediaMetadataCompat.METADATA_KEY_ARTIST, mediaArtist)
      .build()
  mediaSession.setMetadata(metadata)
  

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