Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Gửi tin nhắn ngược dòng trên Android

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Nếu máy chủ ứng dụng của bạn triển khai giao thức Máy chủ kết nối XMPP , thì máy chủ đó có thể nhận các thông báo ngược dòng từ thiết bị của người dùng lên đám mây. Để bắt đầu một thông báo ngược dòng, ứng dụng khách sẽ gửi một yêu cầu có nội dung sau:

  • Địa chỉ của máy chủ ứng dụng nhận ở định dạng SENDER_ID@fcm.googleapis.com .
  • ID tin nhắn phải là duy nhất cho mỗi ID người gửi .
  • Dữ liệu thông báo bao gồm các cặp khóa-giá trị của tải trọng của thông báo.

Khi nhận được dữ liệu này, FCM sẽ tạo một khổ thơ XMPP để gửi đến máy chủ ứng dụng, thêm một số thông tin bổ sung về thiết bị và ứng dụng gửi.

Gửi tin nhắn ngược dòng từ ứng dụng khách Android

Ứng dụng Android của bạn có thể gửi tin nhắn ngược dòng bằng FirebaseMessaging.send :

Kotlin+KTX

val fm = Firebase.messaging
fm.send(remoteMessage("$SENDER_ID@fcm.googleapis.com") {
    setMessageId(messageId.toString())
    addData("my_message", "Hello World")
    addData("my_action", "SAY_HELLO")
})

Java

FirebaseMessaging fm = FirebaseMessaging.getInstance();
fm.send(new RemoteMessage.Builder(SENDER_ID + "@fcm.googleapis.com")
        .setMessageId(Integer.toString(messageId))
        .addData("my_message", "Hello World")
        .addData("my_action","SAY_HELLO")
        .build());

Xử lý các cuộc gọi lại tin nhắn ngược dòng

Với FirebaseMessaging , bạn có thể triển khai các lệnh gọi lại onMessageSentonSendError để kiểm tra trạng thái của các thư ngược dòng. Trong các trường hợp lỗi, onSendError trả về một SendException có mã lỗi. Ví dụ: nếu khách hàng cố gắng gửi thêm tin nhắn sau khi đạt đến giới hạn 20 tin nhắn, nó sẽ trả về SendException#ERROR_TOO_MANY_MESSAGES .

Trong trường hợp thiết bị ngoại tuyến hoặc dịch vụ FCM không khả dụng để chuyển tiếp thư ngược dòng tới máy chủ của bạn, các phiên bản ứng dụng khách Android có thể tích lũy tối đa 20 thư đang chờ xử lý. Nếu những thông báo như vậy hết hạn trước khi FCM có thể gửi chúng thành công, onSendError trả về SendException#ERROR_TTL_EXCEEDED .

Để tối ưu hóa việc sử dụng mạng, FCM nhóm các phản hồi cho onMessageSentonSendError , vì vậy xác nhận có thể không ngay lập tức cho mỗi thư.

Nhận tin nhắn XMPP trên máy chủ ứng dụng

Khi FCM nhận được cuộc gọi nhắn tin ngược dòng từ một ứng dụng khách, nó sẽ tạo khổ thơ XMPP cần thiết để gửi tin nhắn ngược dòng. FCM thêm các trường categoryfrom , sau đó gửi một khổ thơ như sau tới máy chủ ứng dụng:

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "category":"com.example.yourapp", // to know which app sent it
      "data":
      {
          "hello":"world",
      },
      "message_id":"m-123",
      "from":"REGID"
  }
  </gcm>
</message>

Gửi tin nhắn ACK

Để phản hồi một thông báo ngược dòng như trên, máy chủ ứng dụng phải sử dụng cùng một kết nối để gửi một thông báo ACK chứa ID thông báo duy nhất. Nếu FCM không nhận được ACK, nó có thể thử gửi lại tin nhắn đến máy chủ ứng dụng.

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "to":"REGID",
      "message_id":"m-123"
      "message_type":"ack"
  }
  </gcm>
</message>

Xem Tham chiếu máy chủ kết nối XMPP để biết thêm thông tin về cú pháp thông báo ngược dòng.