หากเซิร์ฟเวอร์แอปของคุณใช้โปรโตคอลเซิร์ฟเวอร์การเชื่อมต่อ XMPP เซิร์ฟเวอร์จะสามารถรับข้อความอัปสตรีมจากอุปกรณ์ของผู้ใช้ไปยังระบบคลาวด์ได้ ในการเริ่มต้นข้อความอัปสตรีม แอปไคลเอ็นต์จะส่งคำขอที่มีข้อมูลต่อไปนี้
- ที่อยู่ของเซิร์ฟเวอร์แอปที่เป็นผู้รับในรูปแบบ
SENDER_ID@fcm.googleapis.com
- รหัสข้อความที่ควรไม่ซ้ำกันสำหรับรหัสผู้ส่งแต่ละรหัส
- ข้อมูลข้อความที่ประกอบด้วยคู่คีย์-ค่าของเพย์โหลดของข้อความ
เมื่อได้รับข้อมูลนี้ FCM จะสร้างกลุ่มข้อความ XMPP เพื่อส่งไปยังเซิร์ฟเวอร์ของแอป โดยเพิ่มข้อมูลเพิ่มเติมเกี่ยวกับอุปกรณ์และแอปที่ส่ง
ส่งข้อความอัปสตรีมจากแอปไคลเอ็นต์ Unity
หากต้องการส่งข้อความจากอัปสตรีมไปยังเซิร์ฟเวอร์ แอปไคลเอ็นต์ Unity จะเขียนข้อความและการเรียกใช้ Send
ดังนี้
Firebase.Messaging.Message message;
message.To = SENDER_ID + "@fcm.googleapis.com";
message.MessageId = get_unique_message_id();
message.Data("my_message", "Hello World");
message.Data("my_action", "SAY HELLO");
message.TimeToLive = kTimetoLive;
Firebase.Messaging.FirebaseMessaging.Send(message);
โดยมี
message.To
คือที่อยู่ของเซิร์ฟเวอร์แอปที่เป็นผู้รับในรูปแบบSENDER_ID@fcm.googleapis.com
message.MessageId
คือตัวระบุข้อความที่ไม่ซ้ำกัน ระบบจะระบุการเรียกกลับของผู้รับข้อความทั้งหมดตามรหัสข้อความนี้message.Data
คือแมปคีย์และค่าในรูปแบบสตริงmessage.TimeToLive
ระบุระยะเวลา (เป็นวินาที) ที่ระบบจะเก็บข้อความไว้ในพื้นที่เก็บข้อมูล FCM หากอุปกรณ์ออฟไลน์อยู่ หาก FCM ส่งข้อความไม่ได้ก่อนถึงวันหมดอายุ ก็จะส่งการแจ้งเตือนกลับไปยังไคลเอ็นต์
ไลบรารีของไคลเอ็นต์ FCM จะแคชข้อความในแอปไคลเอ็นต์และส่งเมื่อไคลเอ็นต์มีการเชื่อมต่อเซิร์ฟเวอร์ที่ใช้งานอยู่ เมื่อได้รับข้อความ FCM จะส่งข้อความนั้นไปยังเซิร์ฟเวอร์ของแอป
รับข้อความ 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
ในการตอบสนองต่อข้อความอัปสตรีมเช่นเดียวกับข้างต้น เซิร์ฟเวอร์แอปต้องใช้การเชื่อมต่อเดียวกันเพื่อส่งข้อความ ACK ที่มีรหัสข้อความที่ไม่ซ้ำกัน หาก FCM ไม่ได้รับ ACK อาจลองส่งข้อความไปที่เซิร์ฟเวอร์แอปอีกครั้ง
<message id=""> <gcm xmlns="google:mobile:data"> { "to":"REGID", "message_id":"m-123" "message_type":"ack" } </gcm> </message>
โปรดดูข้อมูลอ้างอิงเซิร์ฟเวอร์การเชื่อมต่อ XMPP สำหรับข้อมูลเพิ่มเติมเกี่ยวกับไวยากรณ์ของข้อความอัปสตรีม