สร้างการแจ้งเตือนรูปแบบการโทรสำหรับแอปการโทร

ใน Android 12.0 (ระดับ API 31) ขึ้นไป ระบบจะมีเทมเพลตการแจ้งเตือน CallStyle เพื่อแยกการแจ้งเตือนสายเรียกเข้าจาก การแจ้งเตือนประเภทอื่นๆ ใช้เทมเพลตนี้เพื่อสร้างการแจ้งเตือนสายเรียกเข้าหรือสายที่สนทนาอยู่ เทมเพลตนี้รองรับการแจ้งเตือนรูปแบบขนาดใหญ่ ซึ่งมีข้อมูลผู้โทรและการดำเนินการที่จำเป็น เช่น การรับสายหรือ ปฏิเสธสาย

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

เทมเพลตการแจ้งเตือน CallStyle มีการดำเนินการที่จำเป็นต่อไปนี้

  • รับ หรือตัดสาย สำหรับสายเรียกเข้า
  • วางสาย สำหรับสายที่สนทนาอยู่
  • รับ หรือวางสาย สำหรับการคัดกรองการโทร

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

การแจ้งเตือนรูปแบบการโทรที่มีปุ่มติดป้ายกำกับ
รูปที่ 1 เทมเพลต CallStyle สำหรับสายเรียกเข้าและสายที่สนทนาอยู่

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

เริ่มตั้งแต่ Android 14 (ระดับ API 34) เป็นต้นไป คุณสามารถกำหนดค่าการแจ้งเตือนการโทรให้ไม่สามารถปิดได้ หากต้องการทำเช่นนั้น ให้ใช้ CallStyle การแจ้งเตือนกับ Notification.FLAG_ONGOING_EVENT ผ่าน Notification.Builder#setOngoing(true)

ต่อไปนี้เป็นตัวอย่างการใช้เมธอดต่างๆ กับการแจ้งเตือน CallStyle

// Create a new call, setting incoming caller.
val incomingCaller = Person.Builder()
    .setName("Jane Doe")
    .setImportant(true)
    .build()

สายเรียกเข้า

ใช้เมธอด forIncomingCall() เพื่อสร้างการแจ้งเตือนรูปแบบการโทรสำหรับสายเรียกเข้า

// For demonstrative purposes only, should use a well-defined Intents.
val contentIntent =
    PendingIntent.getActivity(context, 0, Intent(), PendingIntent.FLAG_IMMUTABLE)
val declineIntent =
    PendingIntent.getActivity(context, 0, Intent(), PendingIntent.FLAG_IMMUTABLE)
val hangupIntent = PendingIntent.getActivity(context, 0, Intent(), PendingIntent.FLAG_IMMUTABLE)
val answerIntent = PendingIntent.getActivity(context, 0, Intent(), PendingIntent.FLAG_IMMUTABLE)
// Create a call style notification for an incoming call.
val builderForIncomingCall = NotificationCompat.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(R.drawable.ic_logo)
    .setStyle(
        NotificationCompat.CallStyle.forIncomingCall(incomingCaller, declineIntent, answerIntent))
    .addPerson(incomingCaller)

สายที่สนทนาอยู่

ใช้เมธอด forOngoingCall() เพื่อสร้างการแจ้งเตือนรูปแบบการโทรสำหรับสายที่สนทนาอยู่

// Create a call style notification for an ongoing call.
val builderForOngoingCall = NotificationCompat.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(R.drawable.ic_logo)
    .setStyle(
        NotificationCompat.CallStyle.forOngoingCall(callerAtOtherEnd, hangupIntent))
    .addPerson(caller)

คัดกรองการโทร

ใช้เมธอด forScreeningCall() เพื่อสร้างการแจ้งเตือนรูปแบบการโทรสำหรับการคัดกรองการโทร

// Create a call style notification for screening a call.
val builder = NotificationCompat.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(R.drawable.ic_logo)
    .setStyle(
        NotificationCompat.CallStyle.forScreeningCall(caller, hangupIntent, answerIntent))
    .addPerson(caller)

มอบความเข้ากันได้ใน Android เวอร์ชันต่างๆ มากขึ้น

เชื่อมโยงการแจ้งเตือน CallStyle ใน API เวอร์ชัน 30 หรือก่อนหน้ากับบริการที่ทำงานอยู่เบื้องหน้าเพื่อกำหนดอันดับสูงให้กับการแจ้งเตือนเหล่านั้นใน API ระดับ 31 ขึ้นไป นอกจากนี้ การแจ้งเตือน CallStyle ใน API เวอร์ชัน 30 หรือก่อนหน้ายังสามารถมีอันดับที่คล้ายกันได้โดยทำเครื่องหมายการแจ้งเตือนเป็น สีโดยใช้เมธอด setColorized()

ใช้ Telecom API กับการแจ้งเตือน CallStyle ดูข้อมูลเพิ่มเติมได้ที่ ภาพรวมของเฟรมเวิร์ก Telecom