รับข้อความโดยใช้ Firebase Cloud Messaging

คู่มือนี้อธิบายวิธีตั้งค่า Firebase Cloud Messaging ในแอปไคลเอ็นต์บนอุปกรณ์เคลื่อนที่และเว็บ เพื่อให้คุณรับข้อความได้อย่างน่าเชื่อถือ

iOS+ Android เว็บ Flutter Unity C++

หากต้องการรับข้อความ คุณสามารถใช้บริการที่ขยาย FirebaseMessagingService บริการของคุณควรลบล้างการเรียกกลับ onMessageReceived และ onDeletedMessages ดูตัวอย่างที่สมบูรณ์ได้ในตัวอย่างคู่มือเริ่มใช้งานฉบับย่อของ Firebase Cloud Messaging

onMessageReceived มีให้ใช้งานสำหรับข้อความส่วนใหญ่ โดยมีข้อยกเว้นต่อไปนี้

• ข้อความแจ้งเตือนที่ส่งเมื่อแอปทำงานอยู่เบื้องหลัง ในกรณีนี้ ระบบจะส่งการแจ้งเตือนไปยังถาดระบบของอุปกรณ์ ผู้ใช้แตะ การแจ้งเตือนจะเปิดตัวเปิดแอปโดยค่าเริ่มต้น

• ข้อความที่มีทั้งเพย์โหลดการแจ้งเตือนและเพย์โหลดข้อมูลเมื่อได้รับใน เบื้องหลัง ในกรณีนี้ ระบบจะส่งการแจ้งเตือนไปยังถาดระบบของอุปกรณ์ และส่งเพย์โหลดข้อมูลในส่วนพิเศษของ Intent ของกิจกรรมตัวเรียกใช้งาน

บทสรุปมีดังนี้:

สถานะของแอป	การแจ้งเตือน	ข้อมูล	ทั้งสอง
พื้นหน้า	onMessageReceived	onMessageReceived	onMessageReceived
ข้อมูลเบื้องต้น	ถาดระบบ	onMessageReceived	การแจ้งเตือน: ข้อมูลถาดระบบ: ในส่วนพิเศษของ Intent

ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทข้อความได้ที่การแจ้งเตือนและข้อความข้อมูล

การเรียกกลับ onMessageReceived มีช่วงเวลาดำเนินการสั้นๆ มีหลายปัจจัยที่อาจ ส่งผลต่อระยะเวลาของช่วงเวลานี้ ซึ่งรวมถึงความล่าช้าของระบบปฏิบัติการ เวลาเริ่มต้นของแอป เทรดหลัก ถูกบล็อกโดยการดำเนินการอื่นๆ หรือการเรียกใช้ onMessageReceived ก่อนหน้า ที่ใช้เวลานานเกินไป

ข้อควรระวัง: หากการประมวลผลเพย์โหลดของข้อความใช้เวลานานกว่า 2-3 วินาที คุณควรตรวจสอบว่าการประมวลผลยังคงดำเนินต่อไปในวงจร กระบวนการที่ถูกต้อง หากคุณไม่ตรวจสอบว่าเกิดเหตุการณ์นี้ขึ้น ข้อจำกัด การดำเนินการในเบื้องหลังอาจทำให้ การประมวลผลหยุดชั่วคราวหรือสิ้นสุดก่อนที่งานจะเสร็จสมบูรณ์ ซึ่งอาจส่งผลให้การแจ้งเตือนผู้ใช้ล่าช้าหรือขาดหายไป

ด้วยเหตุนี้ คุณจึงควรหลีกเลี่ยงงานที่ใช้เวลานาน (เช่น การดึงข้อมูลรูปภาพจากเซิร์ฟเวอร์เพื่อแสดงในการแจ้งเตือน) ใน onMessageReceived และกำหนดเวลางานโดยใช้ WorkManager แทนเพื่อจัดการงานที่อาจใช้เวลามากกว่า 2-3 วินาทีในการดำเนินการให้เสร็จสมบูรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับลำดับความสำคัญของข้อความและผลกระทบต่อการประมวลผลได้ที่การประมวลผลข้อความที่มีลำดับความสำคัญสูงและปกติ

แก้ไขไฟล์ Manifest ของแอป

หากต้องการใช้ FirebaseMessagingService คุณต้องเพิ่มข้อมูลต่อไปนี้ในไฟล์ Manifest ของแอป

<service
    android:name=".java.MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>
AndroidManifest.xml

ขอแนะนําให้ตั้งค่าเริ่มต้นเพื่อปรับแต่งลักษณะที่ปรากฏของ การแจ้งเตือน คุณระบุไอคอนเริ่มต้นที่กำหนดเองและสีเริ่มต้นที่กำหนดเอง ซึ่งจะใช้เมื่อไม่ได้ตั้งค่าที่เทียบเท่าไว้ในเพย์โหลด การแจ้งเตือนได้

เพิ่มบรรทัดต่อไปนี้ภายในแท็ก application เพื่อตั้งค่าไอคอนเริ่มต้นที่กำหนดเองและ สีที่กำหนดเอง

<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
     See README(https://goo.gl/l4GJaQ) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/ic_stat_ic_notification" />
<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
     notification message. See README(https://goo.gl/6BKBk7) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_color"
    android:resource="@color/colorAccent" />
AndroidManifest.xml

Android จะแสดงและใช้ไอคอนเริ่มต้นที่กำหนดเองสำหรับ

• ข้อความแจ้งเตือนทั้งหมดที่ส่งจากเครื่องมือสร้าง การแจ้งเตือน
• ข้อความแจ้งเตือนที่ไม่ได้ตั้งค่าไอคอนอย่างชัดเจนใน เพย์โหลดการแจ้งเตือน

หากไม่ได้ตั้งค่าไอคอนเริ่มต้นที่กำหนดเองและไม่ได้ตั้งค่าไอคอนในเพย์โหลดการแจ้งเตือน Android จะแสดงไอคอนแอปพลิเคชันที่แสดงผลเป็นสีขาว

ลบล้าง onMessageReceived

การลบล้างเมธอด FirebaseMessagingService.onMessageReceived จะช่วยให้คุณ ดำเนินการตาม ออบเจ็กต์ RemoteMessage ที่ได้รับและรับข้อมูลข้อความได้

Kotlin

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: ${remoteMessage.from}")

    // Check if message contains a data payload.
    if (remoteMessage.data.isNotEmpty()) {
        Log.d(TAG, "Message data payload: ${remoteMessage.data}")

        // Check if data needs to be processed by long running job
        if (needsToBeScheduled()) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob()
        } else {
            // Handle message within 10 seconds
            handleNow()
        }
    }

    // Check if message contains a notification payload.
    remoteMessage.notification?.let {
        Log.d(TAG, "Message Notification Body: ${it.body}")
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}
MyFirebaseMessagingService.kt

Java

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    // TODO(developer): Handle FCM messages here.
    // Not getting messages here? See why this may be: https://goo.gl/39bRNJ
    Log.d(TAG, "From: " + remoteMessage.getFrom());

    // Check if message contains a data payload.
    if (remoteMessage.getData().size() > 0) {
        Log.d(TAG, "Message data payload: " + remoteMessage.getData());

        if (/* Check if data needs to be processed by long running job */ true) {
            // For long-running tasks (10 seconds or more) use WorkManager.
            scheduleJob();
        } else {
            // Handle message within 10 seconds
            handleNow();
        }

    }

    // Check if message contains a notification payload.
    if (remoteMessage.getNotification() != null) {
        Log.d(TAG, "Message Notification Body: " + remoteMessage.getNotification().getBody());
    }

    // Also if you intend on generating your own notifications as a result of a received FCM
    // message, here is where that should be initiated. See sendNotification method below.
}
MyFirebaseMessagingService.java

ลบล้าง onDeletedMessages

ในบางกรณี FCM อาจไม่ส่งข้อความ กรณีนี้จะเกิดขึ้นเมื่อ มีข้อความที่รอดำเนินการสำหรับแอปในอุปกรณ์หนึ่งๆ มากเกินไป (>100) ในขณะที่เชื่อมต่อ หรือหากอุปกรณ์ไม่ได้เชื่อมต่อกับ FCM เป็นเวลา นานกว่า 1 เดือน ในกรณีเช่นนี้ คุณอาจได้รับการโทรกลับเพื่อ FirebaseMessagingService.onDeletedMessages() เมื่ออินสแตนซ์ของแอปได้รับ Callback นี้ แอปควรทำการซิงค์แบบเต็มกับเซิร์ฟเวอร์ของแอป หากคุณไม่ได้ส่งข้อความไปยังแอปในอุปกรณ์ดังกล่าวภายใน 4 สัปดาห์ที่ผ่านมา FCMจะไม่โทรหาonDeletedMessages()

จัดการข้อความแจ้งเตือนในแอปที่ทำงานเบื้องหลัง

เมื่อแอปทำงานในเบื้องหลัง Android จะส่งข้อความแจ้งเตือนไปยัง ถาดระบบ เมื่อผู้ใช้แตะการแจ้งเตือน ระบบจะเปิดตัวเปิดแอปโดยค่าเริ่มต้น

ซึ่งรวมถึงข้อความที่มีทั้งเพย์โหลดการแจ้งเตือนและเพย์โหลดข้อมูล (และข้อความทั้งหมดที่ส่งจากคอนโซลการแจ้งเตือน) ในกรณีเหล่านี้ ระบบจะส่งการแจ้งเตือน ไปยังถาดระบบของอุปกรณ์ และส่งเพย์โหลดข้อมูลใน ส่วนพิเศษของ Intent ของกิจกรรมตัวเรียกใช้งาน

ดูข้อมูลเพิ่มเติมเกี่ยวกับการนำส่งข้อความไปยังแอปได้ที่ FCMแดชบอร์ดการรายงาน ซึ่งจะบันทึก จำนวนข้อความที่ส่งและเปิดในอุปกรณ์ Apple และ Android พร้อมกับ ข้อมูลสำหรับ "การแสดงผล" (การแจ้งเตือนที่ผู้ใช้เห็น) สำหรับแอป Android