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

Với Firebase Cloud Messaging API HTTP v1, 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 trên thiết bị iOS từ xa. Xin lưu ý rằng bạn cần có iOS 16.1 để sử dụng hoạt động trực tiếp và iOS 17.2 để bắt đầu thông báo về hoạt động trực tiếp từ xa.

Trước khi bắt đầu

Trước khi bắt đầu sử dụng 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 máy khách của 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 máy khách.

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 để bắt đầu từ Apple. Bạn cũng cần có 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 từ mã mẫu sau để bắt đầu một hoạt động trực tiếp từ xa bằng FCM.

Kiến trúc chuyển trạng thái đại diện (REST)

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Chạy

Nhấp vào Chạy để dùng thử mẫu trong Trình khám phá API.

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 cần có 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 Hoạt động trực tiếp, hãy điền vào trường apns.payload từ mã mẫu sau để cập nhật một hoạt động trực tiếp từ xa bằng FCM.

Kiến trúc chuyển trạng thái đại diện (REST)

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Chạy

Nhấp vào Chạy để dùng thử mẫu trong Trình khám phá API.

Kết thúc một 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 mã thông báo đẩy từ Apple. Bạn cũng cần có FCM mã thông báo đăng ký cho ứng dụng đích.

Để tạo một tải trọng kết thúc một hoạt động trực tiếp , hãy điền vào trường apns.payload từ mẫu mã sau để kết thúc một hoạt động trực tiếp từ xa bằng FCM.

Kiến trúc chuyển trạng thái đại diện (REST)

{
"message": {
  "token": "FCM_TOKEN",
  "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"
        }
      }
    }
  }
}
}

cURL

curl -X POST -H "Authorization: Bearer OAUTH2_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
"message": {
"token": "FCM_TOKEN",
"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"
      }
    }
  }
}
}
}' https://fcm.googleapis.com/v1/projects/YOUR_PROJECT_ID/messages:send

Chạy

Nhấp vào Chạy để dùng thử mẫu trong Trình khám phá API.