使用 Unity 將訊息傳送至裝置群組

裝置群組訊息功能可讓您將多部裝置加入單一群組。 這類似於主題訊息，但包含驗證來確保 群組成員資格只能透過您的伺服器管理。舉例來說 傳送不同的訊息至不同的手機型號，您的伺服器可新增或移除 註冊適當的群組，並向每個群組傳送適當的訊息 群組。裝置群組訊息與主題訊息的差異在於，裝置群組訊息需要透過伺服器管理，而非直接在應用程式中管理。

通知鍵的成員人數上限為 20 人。

管理裝置群組

傳送訊息給裝置群組前，您必須：

1. 取得要加入群組的每部裝置註冊權杖。

2. 建立 notification_key，藉由將特定群組 (通常是使用者) 對應至所有群組的相關註冊權杖，識別裝置群組。您可以在應用程式伺服器上建立通知鍵。

裝置群組的基本管理作業 (建立及移除群組，以及新增或移除裝置) 會透過 HTTP v1 API 執行，並使用短效憑證來授權傳送要求。詳情請參閱 裝置群組管理金鑰，查看支援的金鑰清單。

在應用程式伺服器上管理裝置群組

建立裝置群組

如要建立裝置群組，請傳送提供名稱的 POST 要求 群組，以及裝置的註冊權杖清單。 FCM 會傳回新的 notification_key，代表裝置群組。

HTTP POST 要求

將如下所示的要求傳送至 https://fcm.googleapis.com/fcm/notification：

https://fcm.googleapis.com/fcm/notification
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID

{
   "operation": "create",
   "notification_key_name": "appUser-Chris",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
                        "cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
                        ... ]

notification_key_name 是名稱或 ID 專屬於特定群組的使用者名稱 (例如可以包括的使用者名稱)。 「notification_key_name」和 notification_key 為一組註冊群組的專屬 ID 符記如果您有多個用戶端應用程式使用相同的傳送者 ID，notification_key_name 必須為每個用戶端應用程式提供獨特的 ID。這樣可確保訊息只會傳送至指定的目標應用程式。

回覆格式

成功的要求會傳回 notification_key，例如 包括：

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

請儲存 notification_key 和對應的 notification_key_name，以便在後續作業中使用。

擷取通知鍵

如果您需要擷取現有的通知鍵，請在 GET 要求中使用 notification_key_name，如下所示：

https://fcm.googleapis.com/fcm/notification?notification_key_name=appUser-Chris
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{}

對於每個指定通知鍵名 GET 要求，伺服器會傳回不重複的編碼字串。雖然每個字串看起來都是不同的鍵，但其實都是有效的 `notification_key` 值。

在裝置群組中新增及移除裝置

如要在現有群組中新增或移除裝置，請傳送 POST 要求，並將 operation 參數設為 add 或 remove，然後提供註冊權杖來新增或移除裝置。

HTTP POST 要求

舉例來說，如要新增 裝置中有註冊權杖：bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1... 至 appUser-Chris，您會將這項要求傳送：

{
   "operation": "add",
   "notification_key_name": "appUser-Chris",
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}

回應格式

成功新增或移除裝置後，系統會傳回 notification_key 如下所示：

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

裝置群組管理金鑰

下表列出建立裝置群組的金鑰 以及新增及移除成員

表 10. 裝置群組管理金鑰。

參數	用量	說明
operation	必要，字串	要執行的作業。有效值為 create、add 和 remove。
notification_key_name	必要，字串	要建立或修改的裝置群組使用者定義名稱。
notification_key	必要 (create 作業、字串除外)	裝置群組的專屬 ID。這個值會在成功的 create 作業回應中傳回，且為裝置群組的所有後續作業所需。
registration_ids	必要，字串陣列	要新增或移除的裝置權杖。如果您移除所有的現有 裝置群組中註冊憑證，FCM 會刪除裝置群組。

正在將下游訊息傳送至裝置群組

如要傳送訊息至裝置群組，請使用 HTTP v1 API。如果您目前 將資料傳送至裝置群組 HTTP 或 XMPP，或者是 Firebase Admin SDK 適用於 Node.js 提供舊版通訊協定的更新 遷移至 HTTP v1 API 最先把握舊版 Send API 將於 2024 年 6 月停用並移除。

傳送訊息至裝置群組的方法與傳送 同樣還是向個別裝置傳送訊息 授權傳送要求。將 token 欄位設為群組通知索引鍵：

正在將上游訊息傳送至裝置群組

用戶端應用程式可以透過下列方式，將訊息向上串流至裝置群組 將訊息指定為 「to」欄位。

以下對 FCM 的呼叫會傳送上游 傳送到通知鍵

Firebase.Messaging.Message message;
message.To = notification_key;
message.MessageId = a_unique_message_id;
message.Data["hello"] = "world";
Firebase.Messaging.FirebaseMessaging.Send(message);