Android TV通知实现方法及FCM推送通知可行性与实现方案

嘿，我来帮你梳理Android TV通知实现和FCM推送的要点，这方面我做过不少实践：

一、Android TV原生通知的实现 #

Android TV的通知逻辑和手机端核心一致，但因为设备交互和屏幕特性，需要做一些适配：

• 第一步：创建通知渠道（Android O+必备）
  和手机端一样，Android 8.0及以上必须为通知分配渠道，TV用户也能通过系统设置管理渠道的通知权限。示例代码：

  val channelId = "tv_notification_channel"
  val channelName = "剧集更新通知"
  val channelDescription = "推送新剧集上线、活动提醒等内容"
  val importance = NotificationManager.IMPORTANCE_DEFAULT
  val channel = NotificationChannel(channelId, channelName, importance).apply {
      description = channelDescription
  }
  val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
  notificationManager.createNotificationChannel(channel)
  

• 第二步：构建适配TV的通知
  TV屏幕大、观看距离远，推荐使用BigTextStyle或BigPictureStyle来展示更清晰的内容，同时图标要选择高清晰度的矢量图（避免模糊）。示例代码：

  val notificationBuilder = NotificationCompat.Builder(this, channelId)
      .setSmallIcon(R.drawable.ic_tv_notification)
      .setContentTitle("新剧集上线")
      .setContentText("《西部世界》第四季第5集已更新")
      .setStyle(NotificationCompat.BigTextStyle()
          .bigText("《西部世界》第四季第5集已更新，跟随多洛莉丝的新征程，揭开园区背后的秘密"))
      .setPriority(NotificationCompat.PRIORITY_DEFAULT)
      .setAutoCancel(true)
  
  // 发送通知
  notificationManager.notify(1, notificationBuilder.build())
  

• 注意点：TV的通知会显示在顶部通知栏，用户按下遥控器的「通知」按键时会展开完整列表，确保内容简洁、重点突出，避免过长文本。

二、FCM向Android TV推送通知的可行性 #

完全可行！Android TV基于Android系统内核，原生支持FCM（Firebase Cloud Messaging）服务，和手机端的FCM机制基本一致，只需针对TV的交互特性做少量适配。

三、FCM推送与Android TV展示的完整步骤 #

1. 客户端（Android TV应用）配置 #

• 集成FCM SDK：在模块级build.gradle中添加依赖（建议使用最新稳定版）：

  implementation 'com.google.firebase:firebase-messaging:23.4.0'
  

  同时确保项目根目录的build.gradle包含Firebase插件，并且google-services.json已正确放置在app/目录下。

• 自定义FirebaseMessagingService：创建子类重写onMessageReceived方法，在这里处理FCM消息并构建适配TV的通知。示例：

  class TVFirebaseMessagingService : FirebaseMessagingService() {
      override fun onMessageReceived(remoteMessage: RemoteMessage) {
          super.onMessageReceived(remoteMessage)
          // 获取FCM传递的数据
          val title = remoteMessage.data["title"] ?: "通知"
          val message = remoteMessage.data["message"] ?: "新消息"
          val imageUrl = remoteMessage.data["imageUrl"]
  
          // 构建TV适配的通知
          val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
          val channelId = "tv_fcm_channel"
          // 检查渠道是否存在，不存在则创建
          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
              val channel = NotificationChannel(channelId, "FCM推送通知", NotificationManager.IMPORTANCE_DEFAULT)
              notificationManager.createNotificationChannel(channel)
          }
  
          val notificationBuilder = NotificationCompat.Builder(this, channelId)
              .setSmallIcon(R.drawable.ic_tv_notification)
              .setContentTitle(title)
              .setContentText(message)
              .setPriority(NotificationCompat.PRIORITY_DEFAULT)
              .setAutoCancel(true)
  
          // 如果有图片，使用BigPictureStyle
          imageUrl?.let {
              val bitmap = getBitmapFromUrl(it) // 实现一个从URL加载图片的方法
              bitmap?.let { bmp ->
                  notificationBuilder.setStyle(NotificationCompat.BigPictureStyle().bigPicture(bmp))
              }
          } ?: run {
              // 没有图片则用BigTextStyle
              notificationBuilder.setStyle(NotificationCompat.BigTextStyle().bigText(message))
          }
  
          notificationManager.notify(System.currentTimeMillis().toInt(), notificationBuilder.build())
      }
  
      // 辅助方法：从URL加载图片为Bitmap
      private fun getBitmapFromUrl(url: String): Bitmap? {
          return try {
              val inputStream = URL(url).openStream()
              BitmapFactory.decodeStream(inputStream)
          } catch (e: IOException) {
              e.printStackTrace()
              null
          }
      }
  }
  

• 注册Service到Manifest：在AndroidManifest.xml中添加：

  <service
      android:name=".TVFirebaseMessagingService"
      android:exported="false">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

2. 服务器端发送FCM消息 #

你可以选择两种方式发送：

• Firebase控制台：适合测试，直接在Firebase控制台的「Cloud Messaging」页面，选择「发送测试消息」，输入设备的FCM令牌，填写标题和内容即可发送。
• HTTP API发送：适合生产环境的批量推送，发送POST请求到https://fcm.googleapis.com/fcm/send，请求头包含：
  • Authorization: key=你的FCM服务器密钥（在Firebase控制台的「项目设置」→「云消息传递」中获取）
  • Content-Type: application/json
    请求体示例（推荐使用data payload，方便客户端自定义TV通知样式）：

  {
    "to": "你的Android TV设备FCM令牌",
    "data": {
      "title": "会员专属福利",
      "message": "你的月度会员已续费成功，可观看全部VIP剧集",
      "imageUrl": "https://example.com/vip_banner.jpg"
    }
  }
  

3. 关键注意事项 #

• 避免发送过于频繁的通知，TV用户对打扰的敏感度更高；
• 确保通知图标符合Android TV设计规范，建议使用至少48x48dp的矢量图；
• 如果应用在后台，FCM的notification payload会由系统自动展示，这时候要确保payload里的内容适配TV阅读体验，优先推荐使用data payload由客户端自主构建通知；
• 测试时务必使用真实Android TV设备或官方TV模拟器，避免兼容性问题。

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