Làm quen với tính năng Hoạt động trực tiếp

Với API HTTP v1 của Firebase Cloud Messaging, bạn có thể gửi, cập nhật và kết thúc thông báo về hoạt động trực tiếp từ xa trên các thiết bị iOS. Xin lưu ý rằng bạn cần iOS 16.1 để sử dụng hoạt động trực tiếp và iOS 17.2 để bắt đầu thông báo hoạt động trực tiếp từ xa.

Trước khi bắt đầu

Trước khi bạn bắt đầu hoạt động trực tiếp trên Firebase Cloud Messaging, hãy làm theo hướng dẫn trong bài viết Thiết lập ứng dụng Gửi thông báo qua đám mây của Firebase trên các nền tảng của Apple để tạo và thêm Firebase Cloud Messaging vào ứng dụng khách của bạn.

Bắt đầu một hoạt động phát trực tiếp

Để bắt đầu một hoạt động trực tiếp từ xa bằng Firebase Cloud Messaging, bạn cần lấy mã thông báo đẩy để bắt đầu từ Apple. Bạn cũng sẽ cần mã thông báo đăng ký FCM cho ứng dụng mục tiêu.

Để tạo một trọng tải bắt đầu một hoạt động trực tiếp, hãy điền vào trường apns.payload từ mã mẫu sau để bắt đầu từ xa một hoạt động trực tiếp bằng FCM. Bạn có thể sử dụng Trình khám phá API để tạo và kiểm thử tải trọng.

"message":{
    "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_to_start_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "event": "start",
          "content-state": {
            "demo": 1
          },
          "attributes-type": "DemoAttributes",
          "attributes": {
            "demoAttribute": 1,
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }

Cập nhật hoạt động trực tiếp

Để cập nhật hoạt động trực tiếp từ xa bằng Firebase Cloud Messaging, bạn cần lấy mã thông báo đẩy từ Apple. Bạn cũng sẽ cần mã thông báo đăng ký FCM cho ứng dụng mục tiêu.

Để tạo một tải trọng cập nhật Hoạt động trực tiếp, hãy điền vào trường apns.payload trong mã mẫu sau để cập nhật từ xa một hoạt động đang hoạt động bằng FCM. Bạn có thể sử dụng API Explorer (Trình khám phá API) để tạo và kiểm thử tải trọng của mình.

"message":{
    "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "event": "update",
          "content-state": {
            "test1": 100,
            "test2": "demo"
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }
}

Kết thúc hoạt động phát trực tiếp

Để kết thúc một hoạt động trực tiếp bằng Firebase Cloud Messaging, bạn cần nhận mã thông báo đẩy từ Apple. Bạn cũng sẽ cần mã thông báo đăng ký FCM cho ứng dụng đích.

Để tạo trọng tải kết thúc hoạt động trực tiếp, hãy điền vào trường apns.payload trong mã mẫu sau để kết thúc hoạt động trực tiếp từ xa bằng FCM. Bạn có thể sử dụng API Explorer (Trình khám phá API) để tạo và kiểm thử tải trọng của mình.

"message":{
     "token": "<fcm_token:test>",
    "apns":{
      "live_activity_token": "<live_activity_push_token>",
      "headers":{
        "apns-priority": "10"
      },
      "payload":{
        "aps": {
          "timestamp": <timestamp>,
          "dismissal-date": <dismissal_date>,
          "event": "end",
          "content-state": {
            "test1": 100,
            "test2": "demo"
          },
          "alert": {
            "title": "test title",
            "body": "test body"
          }
        }
      }
    }
  }
}