如果您的應用程式伺服器實現XMPP 連接伺服器協議,它可以接收從用戶設備到雲端的上游訊息。若要發起上游訊息,用戶端應用程式會傳送包含以下內容的請求:
- 接收應用程式伺服器的位址,格式為
SENDER_ID@fcm.googleapis.com
。 - 對於每個寄件者 ID來說,訊息 ID 應該是唯一的。
- 訊息資料包含訊息有效負載的鍵值對。
當收到此資料時,FCM 會建立一個 XMPP 節以傳送到應用程式伺服器,並新增有關傳送裝置和應用程式的一些附加資訊。
從 Android 用戶端應用程式發送上游訊息
您的 Android 應用程式可以使用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());
處理上游訊息回調
使用FirebaseMessaging
,您可以實現回呼onMessageSent
和onSendError
來檢查上游訊息的狀態。在錯誤情況下, onSendError
會傳回帶有錯誤代碼的SendException
。例如,如果客戶端在達到 20 個訊息限制後嘗試發送更多訊息,則會傳回SendException#ERROR_TOO_MANY_MESSAGES
。
如果裝置離線或 FCM 服務無法將上游訊息轉發到您的伺服器,Android 用戶端應用程式實例最多可以累積 20 個待處理訊息。如果此類訊息在 FCM 成功傳送之前過期, onSendError
將傳回SendException#ERROR_TTL_EXCEEDED
。
為了優化網路使用,FCM 批次回應onMessageSent
和onSendError
,因此每個訊息可能不會立即得到確認。
在應用程式伺服器上接收 XMPP 訊息
當 FCM 從客戶端應用程式接收到上游訊息傳遞呼叫時,它會產生發送上游訊息所需的 XMPP 節。 FCM 新增category
和from
字段,然後將如下所示的節傳送到應用程式伺服器:
<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>
發送ACK訊息
為了回應上述上游訊息,應用程式伺服器必須使用相同的連線來傳送包含唯一訊息 ID 的 ACK 訊息。如果 FCM 沒有收到 ACK,它可能會重試將訊息傳送到應用程式伺服器。
<message id=""> <gcm xmlns="google:mobile:data"> { "to":"REGID", "message_id":"m-123" "message_type":"ack" } </gcm> </message>
有關上游訊息語法的更多信息,請參閱XMPP 連接伺服器參考。