重定向呼叫

搭载 Android 10 或更高版本的设备与搭载 Android 9 或更低版本的设备管理通话 intent 的方式不同。在 Android 10 及更高版本中,ACTION_NEW_OUTGOING_CALL 广播已弃用,取而代之的是 CallRedirectionService API。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()
            }
        }
    }
}

您必须在清单中注册此服务,以便系统可以正确启动它。

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

如需使用重定向服务,您的应用必须向 RoleManager 请求通话重定向角色。这将询问用户是否要允许您的应用处理通话重定向。如果您的应用未被授予此角色,则系统不会使用您的重定向服务。

您应在用户启动应用时检查应用是否具有此角色,以便根据需要请求此角色。您启动由 RoleManager 创建的 intent,因此请务必替换 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
    }
}