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

Với Firebase Cloud Messaging HTTP v1 API, bạn có thể gửi, cập nhật và kết thúc thông báo 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 có iOS 16.1 để sử dụng tính nă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ắt đầu với tính năng hoạt động trực tiếp trên Firebase Cloud Messaging, hãy làm theo hướng dẫn trong phần Thiết lập ứng dụng khách Giải pháp 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 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 để khởi động từ Apple. Bạn cũng sẽ cần FCM mã thông báo đăng ký cho ứng dụng đích.

Để tạo một tải trọng bắt đầu một hoạt động trực tiếp, hãy điền vào trường apns.payload trong đoạn mã sau để bắt đầu một hoạt động trực tiếp từ xa bằng cách sử dụng FCM. Bạn có thể sử dụng API Explorer để 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 một hoạt động trực tiếp

Để cập nhật 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 từ Apple. Bạn cũng sẽ cần FCM mã thông báo đăng ký cho ứng dụng đích.

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

"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 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 lấy push token (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 một tải trọng kết thúc hoạt động trực tiếp, hãy điền vào trường apns.payload trong đoạn mã sau để kết thúc từ xa một hoạt động trực tiếp bằng FCM. Bạn có thể sử dụng API Explorer để tạo và kiểm thử tải trọng.

"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"
          }
        }
      }
    }
  }
}