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

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

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

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

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

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

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

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดู InCallService

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

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

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

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

  • ใช้ 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() จะรวมข้อมูลจากผู้ให้บริการเครือข่ายเกี่ยวกับอีกหมายเลขหนึ่ง หากสถานะการยืนยันล้มเหลว นั่นเป็นตัวบ่งชี้ที่ดีว่าการโทร จากหมายเลขที่ไม่ถูกต้อง หรือสายที่อาจเป็นสแปม

Kotlin

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.
                }
            }
        }
    }
}

Java

class ScreeningService extends CallScreeningService {
    @Override
    public void onScreenCall(@NonNull Call.Details callDetails) {
        boolean isIncoming = callDetails.getCallDirection() == Call.Details.DIRECTION_INCOMING;

        if (isIncoming) {
            Uri handle = callDetails.getHandle();

            switch (callDetails.getCallerNumberVerificationStatus()) {
                case Connection.VERIFICATION_STATUS_FAILED:
                    // Network verification failed, likely an invalid/spam call.
                    break;
                case Connection.VERIFICATION_STATUS_PASSED:
                    // Network verification passed, likely a valid call.
                    break;
                default:
                    // Network could not perform verification.
                    // This branch matches Connection.VERIFICATION_STATUS_NOT_VERIFIED
            }
        }
    }
}

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

Kotlin

// 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)

Java

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

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

คุณต้องลงทะเบียนการใช้งาน 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 เลิกใช้งานการออกอากาศแล้ว และแทนที่ด้วย CallRedirectionService API CallRedirectionService มีอินเทอร์เฟซให้คุณใช้เพื่อ แก้ไขสายโทรออกที่โทรออกโดยแพลตฟอร์ม Android เช่น บุคคลที่สาม แอปอาจยกเลิกการโทรและเปลี่ยนเส้นทางผ่าน VoIP

Kotlin

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()
            }
        }
    }
}

Java

class RedirectionService extends CallRedirectionService {
    @Override
    public void onPlaceCall(
            @NonNull Uri handle,
            @NonNull PhoneAccountHandle initialPhoneAccount,
            boolean allowInteractiveResponse
    ) {
        // Determine if the call should proceed, be redirected, or cancelled.
        // Your app should implement this logic to determine the redirection.
        boolean callShouldProceed = true;
        boolean callShouldRedirect = false;
        if (callShouldProceed) {
            placeCallUnmodified();
        } else if (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() จัดการการเลือกของผู้ใช้

Kotlin

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 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
    }
}

Java

class MainActivity extends AppCompatActivity {
    private static final int REDIRECT_ROLE_REQUEST_CODE = 0;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 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) {
            RoleManager roleManager = (RoleManager) getSystemService(Context.ROLE_SERVICE);
            // Check if the app needs to register call redirection role.
            boolean shouldRequestRole = roleManager.isRoleAvailable(RoleManager.ROLE_CALL_REDIRECTION) &&
                    !roleManager.isRoleHeld(RoleManager.ROLE_CALL_REDIRECTION);
            if (shouldRequestRole) {
                Intent intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_CALL_REDIRECTION);
                startActivityForResult(intent, REDIRECT_ROLE_REQUEST_CODE);
            }
        }
    }
}