ภาพรวมเฟรมเวิร์กโทรคมนาคม

เฟรมเวิร์ก Android Telecom (หรือที่เรียกสั้นๆ ว่า "Telecom") จะจัดการการโทรด้วยเสียงและวิดีโอคอลในอุปกรณ์ที่ใช้ Android ซึ่งรวมถึงการโทรผ่านซิม เช่น การโทรที่ใช้เฟรมเวิร์กโทรศัพท์ และการโทรผ่าน VoIP ที่ใช้ไลบรารี Core-Telecom Jetpack

องค์ประกอบหลักที่ Telecom จัดการคือ ConnectionService และ InCallService

การติดตั้งใช้งาน ConnectionService จะสร้างขึ้นจากเทคโนโลยีอย่าง PSTN เพื่อเชื่อมต่อการโทรกับบุคคลอื่น การติดตั้งใช้งาน ConnectionService ที่พบบ่อยที่สุดในโทรศัพท์คือ ConnectionService ของโทรศัพท์ โดยจะเชื่อมต่อการโทรผ่านผู้ให้บริการ

การติดตั้งใช้งาน InCallService จะมอบอินเทอร์เฟซผู้ใช้สำหรับการโทรที่จัดการโดย Telecom และอนุญาตให้ผู้ใช้ควบคุมและโต้ตอบกับการโทรเหล่านี้ การใช้งาน InCallService ที่พบบ่อยที่สุดคือแอปโทรศัพท์ที่มาพร้อมกับอุปกรณ์

โทรคมนาคมทำหน้าที่เป็นสวิตช์บอร์ด โดยจะกำหนดเส้นทางการโทรที่การติดตั้งใช้งาน ConnectionService มีให้ไปยังอินเทอร์เฟซผู้ใช้สำหรับการโทรที่การติดตั้งใช้งาน InCallService มีให้

คุณอาจต้องการใช้ Telecom API ด้วยเหตุผลต่อไปนี้

สร้างแอปโทรศัพท์ทดแทน

หากต้องการสร้างแอปทดแทนแอปโทรศัพท์เริ่มต้นในอุปกรณ์ Android ให้ใช้ InCallService API การติดตั้งใช้งานต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • โดยต้องไม่มีความสามารถในการโทร และต้องประกอบด้วยอินเทอร์เฟซผู้ใช้สำหรับการโทรเท่านั้น
  • โดยต้องจัดการการโทรทั้งหมดที่เฟรมเวิร์ก Telecom ทราบ และไม่ตั้งสมมติฐานเกี่ยวกับลักษณะของการโทร เช่น ต้องไม่ถือว่าการโทรเป็นการโทรผ่านระบบโทรศัพท์ที่ใช้ซิม และต้องไม่ใช้ข้อจำกัดการโทรที่อิงตาม ConnectionService ใดๆ เช่น การบังคับใช้ข้อจำกัดของระบบโทรศัพท์สำหรับวิดีโอคอล

ดูข้อมูลเพิ่มเติมได้ที่ InCallService

ผสานรวมโซลูชันการโทร

หากต้องการผสานรวมโซลูชันการโทรเข้ากับ Android คุณมีตัวเลือกต่อไปนี้

  • ใช้ไลบรารี Core-Telecom Jetpack ที่มีการจัดการด้วยตนเอง: ตัวเลือกนี้เหมาะสำหรับนักพัฒนาแอปการโทรแบบสแตนด์อโลนที่ไม่ต้องการแสดงการโทรภายในแอปโทรศัพท์เริ่มต้น และไม่ต้องการให้การโทรอื่นๆ แสดงในอินเทอร์เฟซผู้ใช้ของตน

    เมื่อผสานรวมกับไลบรารี Jetpack Core-Telecom คุณจะช่วยให้แอปทำงานร่วมกันได้ไม่เพียงแต่กับการโทรผ่านระบบโทรศัพท์ในอุปกรณ์เท่านั้น แต่ยังรวมถึงแอปการโทรแบบสแตนด์อโลนอื่นๆ ที่ผสานรวมกับ Telecom ด้วย นอกจากนี้ ไลบรารี Core-Telecom ยังจัดการการกำหนดเส้นทางเสียงและการโฟกัสด้วย โปรดดูรายละเอียดที่หัวข้อสร้างแอปการโทร

  • ใช้ ConnectionService API ที่มีการจัดการ: ตัวเลือกนี้ช่วยอำนวยความสะดวกในการพัฒนาโซลูชันการโทรที่อาศัยแอปพลิเคชันโทรศัพท์ของอุปกรณ์ที่มีอยู่เพื่อมอบอินเทอร์เฟซผู้ใช้สำหรับการโทร ตัวอย่างเช่น การติดตั้งใช้งานการโทรผ่าน SIP และบริการโทรผ่าน VoIP ของบุคคลที่สาม ดูรายละเอียดเพิ่มเติมได้ที่ getDefaultDialerPackage()

    ConnectionService เพียงอย่างเดียวเป็นเพียงช่องทางในการเชื่อมต่อการโทรเท่านั้น โดยไม่มีอินเทอร์เฟซผู้ใช้ที่เชื่อมโยง

  • ใช้ทั้ง InCallService และ ConnectionService API: ตัวเลือกนี้เหมาะอย่างยิ่งหากคุณต้องการสร้างโซลูชันการโทรที่ใช้ ConnectionService ของคุณเอง พร้อมด้วยอินเทอร์เฟซผู้ใช้ของตัวเอง และแสดงการโทรอื่นๆ ทั้งหมดใน Android ในอินเทอร์เฟซผู้ใช้เดียวกันด้วย เมื่อใช้วิธีนี้ การติดตั้งใช้งาน InCallService ต้องไม่ตั้งสมมติฐานเกี่ยวกับแหล่งที่มาของการโทรที่แสดง นอกจากนี้ การติดตั้งใช้งาน ConnectionService ของคุณต้องทำงานต่อไปได้โดยไม่ต้องตั้งค่าแอปโทรศัพท์เริ่มต้นเป็น InCallService ที่กำหนดเอง

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

อุปกรณ์ที่ใช้ Android 10 (ระดับ API 29) ขึ้นไปจะอนุญาตให้แอปของคุณระบุการโทรจากหมายเลขที่ไม่ได้อยู่ในสมุดที่อยู่ของผู้ใช้ว่าอาจเป็นการโทรสแปม ผู้ใช้เลือกที่จะปฏิเสธการโทรสแปมโดยไม่มีเสียงได้ ระบบจะบันทึกข้อมูลเกี่ยวกับการโทรที่ถูกบล็อกเหล่านี้ไว้ในบันทึกการโทร เพื่อให้ผู้ใช้มีความโปร่งใสมากขึ้นเมื่อมีสายที่ไม่ได้รับ การใช้ Android 10 API จะช่วยลดความจำเป็นในการขอสิทธิ์ READ_CALL_LOG จากผู้ใช้เพื่อให้บริการฟังก์ชันการสกรีนสายเรียกเข้าและหมายเลขผู้โทร

คุณใช้การติดตั้งใช้งาน CallScreeningService เพื่อสกรีนสายเรียกเข้า เรียกใช้ฟังก์ชัน onScreenCall() สำหรับสายโทรเข้าหรือสายโทรออกใหม่เมื่อหมายเลขไม่อยู่ในข้อมูลรายชื่อติดต่อของผู้ใช้ คุณสามารถตรวจสอบออบเจ็กต์ Call.Details เพื่อดูข้อมูลเกี่ยวกับการโทรได้ กล่าวคือ ฟังก์ชัน getCallerNumberVerificationStatus() จะมีข้อมูลจากผู้ให้บริการเครือข่ายเกี่ยวกับหมายเลขอื่น หากสถานะการยืนยันไม่สำเร็จ แสดงว่าการโทรนั้นมาจากหมายเลขที่ไม่ถูกต้องหรืออาจเป็นการโทรสแปม

class ScreeningService : CallScreeningService() {
    // This function is called when an ingoing or outgoing call
    // is from a number not in the user's contacts list
    override fun onScreenCall(callDetails: Call.Details) {
        // Can check the direction of the call
        val isIncoming = callDetails.callDirection == Call.Details.DIRECTION_INCOMING

        if (isIncoming) {
            // the handle (e.g. phone number) that the Call is currently connected to
            val handle: Uri = callDetails.handle

            // determine if you want to allow or reject the call
            when (callDetails.callerNumberVerificationStatus) {
                Connection.VERIFICATION_STATUS_FAILED -> {
                    // Network verification failed, likely an invalid/spam call.
                }
                Connection.VERIFICATION_STATUS_PASSED -> {
                    // Network verification passed, likely a valid call.
                }
                else -> {
                    // Network could not perform verification.
                    // This branch matches Connection.VERIFICATION_STATUS_NOT_VERIFIED.
                }
            }
        }
    }
}

ตั้งค่าฟังก์ชัน onScreenCall() ให้เรียกใช้ respondToCall() เพื่อบอกระบบว่าจะตอบสนองต่อการโทรใหม่อย่างไร ฟังก์ชันนี้ใช้พารามิเตอร์ CallResponse ที่คุณสามารถใช้เพื่อบอกให้ระบบบล็อกการโทร ปฏิเสธการโทรเสมือนว่าผู้ใช้เป็นผู้ปฏิเสธ หรือปิดเสียงการโทร นอกจากนี้ คุณยังบอกให้ระบบข้ามการเพิ่มการโทรนี้ลงในบันทึกการโทรของอุปกรณ์ได้ด้วย

// Tell the system how to respond to the incoming call
// and if it should notify the user of the call.
val response = CallResponse.Builder()
    // Sets whether the incoming call should be blocked.
    .setDisallowCall(false)
    // Sets whether the incoming call should be rejected as if the user did so manually.
    .setRejectCall(false)
    // Sets whether ringing should be silenced for the incoming call.
    .setSilenceCall(false)
    // Sets whether the incoming call should not be displayed in the call log.
    .setSkipCallLog(false)
    // Sets whether a missed call notification should not be shown for the incoming call.
    .setSkipNotification(false)
    .build()

// Call this function to provide your screening response.
respondToCall(callDetails, response)

คุณต้องลงทะเบียนการติดตั้งใช้งาน CallScreeningService ในไฟล์ Manifest ด้วยตัวกรอง Intent และสิทธิ์ที่เหมาะสมเพื่อให้ระบบเรียกใช้ได้อย่างถูกต้อง

<service
    android:name=".ScreeningService"
    android:permission="android.permission.BIND_SCREENING_SERVICE">
    <intent-filter>
        <action android:name="android.telecom.CallScreeningService" />
    </intent-filter>
</service>

เปลี่ยนเส้นทางการโทร

อุปกรณ์ที่ใช้ Android 10 ขึ้นไปจะจัดการ Intent การโทรแตกต่างจากอุปกรณ์ที่ใช้ Android 9 หรือต่ำกว่า ใน Android 10 ขึ้นไป การออกอากาศ ACTION_NEW_OUTGOING_CALL จะเลิกใช้งานและแทนที่ด้วย API CallRedirectionService CallRedirectionService มีอินเทอร์เฟซให้คุณใช้เพื่อแก้ไขสายโทรออกที่ดำเนินการโดยแพลตฟอร์ม Android เช่น แอปของบุคคลที่สามอาจยกเลิกการโทรและเปลี่ยนเส้นทางการโทรผ่าน VoIP

class RedirectionService : CallRedirectionService() {
    override fun onPlaceCall(
        handle: Uri,
        initialPhoneAccount: PhoneAccountHandle,
        allowInteractiveResponse: Boolean
    ) {
        // Determine if the call should proceed, be redirected, or cancelled.
        val callShouldProceed = true
        val callShouldRedirect = false
        when {
            callShouldProceed -> {
                placeCallUnmodified()
            }
            callShouldRedirect -> {
                // Update the URI to point to a different phone number or modify the
                // PhoneAccountHandle and redirect.
                redirectCall(handle, initialPhoneAccount, true)
            }
            else -> {
                cancelCall()
            }
        }
    }
}

คุณต้องลงทะเบียนบริการนี้ในไฟล์ Manifest เพื่อให้ระบบเริ่มบริการได้อย่างถูกต้อง

<service
    android:name=".RedirectionService"
    android:permission="android.permission.BIND_CALL_REDIRECTION_SERVICE">
    <intent-filter>
        <action android:name="android.telecom.CallRedirectionService"/>
    </intent-filter>
</service>

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

คุณควรตรวจสอบว่าแอปมีบทบาทนี้หรือไม่เมื่อผู้ใช้เปิดแอป เพื่อให้คุณขอสิทธิ์ได้ตามต้องการ คุณเปิด Intent ที่สร้างโดย RoleManager ดังนั้นโปรดลบล้างฟังก์ชัน onActivityResult() เพื่อจัดการการเลือกของผู้ใช้

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Tell the system that you want your app to handle call redirects. This
        // is done by using the RoleManager to register your app to handle redirects.
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
            val roleManager = getSystemService(Context.ROLE_SERVICE) as RoleManager
            // Check if the app needs to register call redirection role.
            val shouldRequestRole = roleManager.isRoleAvailable(RoleManager.ROLE_CALL_REDIRECTION) &&
                !roleManager.isRoleHeld(RoleManager.ROLE_CALL_REDIRECTION)
            if (shouldRequestRole) {
                val intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_CALL_REDIRECTION)
                startActivityForResult(intent, REDIRECT_ROLE_REQUEST_CODE)
            }
        }
    }

    companion object {
        private const val REDIRECT_ROLE_REQUEST_CODE = 1
    }
}