รับข้อความในแอป Android

การแจ้งเตือน Firebase จะทำงานแตกต่างกันไปโดยขึ้นอยู่กับสถานะเบื้องหน้า/เบื้องหลังของแอปที่รับ หากต้องการให้แอปที่ทำงานอยู่เบื้องหน้าได้รับข้อความการแจ้งเตือนหรือข้อความข้อมูล คุณจะต้องเขียนโค้ดเพื่อจัดการการเรียกกลับ onMessageReceived ดูคำอธิบายความแตกต่างระหว่างข้อความการแจ้งเตือนและข้อความข้อมูลได้ที่ประเภทข้อความ

การจัดการข้อความ

หากต้องการรับข้อความ ให้ใช้บริการที่ขยาย FirebaseMessagingService บริการของคุณควรลบล้างการเรียกกลับ onMessageReceived และ onDeletedMessages

บริการของคุณควรจัดการข้อความภายใน 20 วินาทีหลังจากได้รับ

กรอบเวลาการจัดการข้อความอาจสั้นกว่า 20 วินาที ทั้งนี้ขึ้นอยู่กับความล่าช้าที่เกิดขึ้นก่อนการเรียก onMessageReceived ซึ่งรวมถึงความล่าช้าของระบบปฏิบัติการ เวลาเริ่มต้นของแอป การดำเนินการอื่นๆ ที่บล็อกเธรดหลัก หรือการเรียก onMessageReceived ก่อนหน้านี้ที่ใช้เวลานานเกินไป หลังจากเวลาดังกล่าว ลักษณะการทํางานของระบบปฏิบัติการต่างๆ เช่น การสิ้นสุดกระบวนการของ Android หรือ การจํากัดการดําเนินการในเบื้องหลังของ Android O อาจรบกวนความสามารถในการทํางานให้เสร็จสมบูรณ์

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

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

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

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

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

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

แก้ไขไฟล์ 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 ใช้สีเริ่มต้นที่กำหนดเองสำหรับ

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

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

ลบล้าง onMessageReceived

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

Kotlin+KTX

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() เมื่ออินสแตนซ์แอปได้รับการเรียกกลับนี้ อินสแตนซ์ควรทำการซิงค์แบบเต็มกับเซิร์ฟเวอร์แอป หากคุณไม่ได้ส่งข้อความไปยังแอปในอุปกรณ์ดังกล่าวภายใน 4 สัปดาห์ที่ผ่านมา FCM จะไม่โทรหา onDeletedMessages()

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

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

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

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

รับข้อความ FCM ในโหมดการบูตโดยตรง

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

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

ข้อกำหนดเบื้องต้น

• อุปกรณ์ต้องได้รับการตั้งค่าสำหรับโหมดการบูตโดยตรง
• อุปกรณ์ต้องติดตั้งบริการ Google Play เวอร์ชันล่าสุด (19.0.54 ขึ้นไป)
• แอปต้องใช้ FCM SDK (com.google.firebase:firebase-messaging) เพื่อรับข้อความ FCM

เปิดใช้การจัดการข้อความโหมดเปิดเครื่องโดยตรงในแอป

1. ในไฟล์ Gradle ระดับแอป ให้เพิ่มการพึ่งพาไลบรารีการสนับสนุนการบูตโดยตรงของ FCM ดังนี้

   implementation 'com.google.firebase:firebase-messaging-directboot:20.2.0'
   

2. ทําให้ FirebaseMessagingService ของแอปรับรู้การบูตโดยตรงด้วยการเพิ่มแอตทริบิวต์ android:directBootAware="true" ในไฟล์ Manifest ของแอป

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

คุณต้องตรวจสอบว่า FirebaseMessagingService นี้ทำงานได้ในโหมดการบูตโดยตรง ตรวจสอบข้อกำหนดต่อไปนี้

• บริการไม่ควรเข้าถึงพื้นที่เก็บข้อมูลที่ป้องกันด้วยข้อมูลเข้าสู่ระบบขณะทำงานในโหมดการบูตโดยตรง
• บริการไม่ควรพยายามใช้คอมโพเนนต์ เช่น Activities, BroadcastReceivers หรือ Services อื่นๆ ที่ไม่ได้ทําเครื่องหมายว่ารับรู้การบูตโดยตรงขณะทํางานในโหมดการบูตโดยตรง
• ไลบรารีที่บริการใช้ต้องไม่เข้าถึงพื้นที่เก็บข้อมูลที่ปกป้องข้อมูลเข้าสู่ระบบหรือเรียกใช้คอมโพเนนต์ที่ไม่ใช่ directBootAware ขณะทำงานในโหมดการบูตโดยตรง ซึ่งหมายความว่าไลบรารีทั้งหมดที่แอปใช้ซึ่งเรียกจากบริการจะต้องรองรับการบูตโดยตรง หรือแอปจะต้องตรวจสอบว่ากำลังทำงานในโหมดการบูตโดยตรงหรือไม่ และจะไม่เรียกใช้ไลบรารีเหล่านั้นในโหมดนั้น ตัวอย่างเช่น Firebase SDK ทำงานร่วมกับการบูตโดยตรงได้ (รวมไว้ในแอปได้โดยไม่ทำให้แอปขัดข้องในโหมดการบูตโดยตรง) แต่ Firebase API จํานวนมากไม่รองรับการเรียกใช้ในโหมดการบูตโดยตรง
• หากแอปใช้ Application ที่กําหนดเอง Application จะต้องรองรับการบูตโดยตรงด้วย (ไม่มีสิทธิ์เข้าถึงพื้นที่เก็บข้อมูลที่ปกป้องด้วยข้อมูลเข้าสู่ระบบในโหมดการบูตโดยตรง)

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