如何解决Android应用添加系统管理来电时的‘Phone Account Handle未启用’错误

问题场景 #

在实现系统管理连接的呼入电话处理流程时，完成TelecomManager初始化和PhoneAccount注册后，调用addNewIncomingCall模拟来电时触发错误：Phone Account Handle is not enabled for this user。

相关代码如下：

1. 初始化TelecomManager #

private void initializeTelecomManager(){
    Context context=this.getAppContext();
    ComponentName cName = new ComponentName(context, VoiceConnectionService.class);
    String appName=this.getApplicationName(context);
    handle = new PhoneAccountHandle(cName, appName);
    telecomManager = (TelecomManager) context.getSystemService(Context.TELECOM_SERVICE);
}

2. 注册Phone Account Handle #

this.initializeTelecomManager();
String appName = this.getApplicationName(this.getAppContext());
PhoneAccount.Builder builder = new PhoneAccount.Builder(handle, appName)
        .setCapabilities(PhoneAccount.CAPABILITY_CALL_PROVIDER);

PhoneAccount account = builder.build();

telephonyManager = (TelephonyManager) this.getAppContext().getSystemService(Context.TELEPHONY_SERVICE);

telecomManager.registerPhoneAccount(account);

模拟来电代码 #

Bundle extras = new Bundle();
Uri uri = Uri.fromParts(PhoneAccount.SCHEME_TEL, "1234567890", null);

extras.putParcelable(TelecomManager.EXTRA_INCOMING_CALL_ADDRESS, uri);
extras.putString("EXTRA_CALLER_NAME", callerName);
extras.putString("EXTRA_CALL_UUID", uuid);

telecomManager.addNewIncomingCall(handle, extras);

错误原因 #

注册PhoneAccount后，该账号默认处于未启用状态，而TelecomManager仅允许已启用的PhoneAccount发起或接收来电请求，因此触发该错误。

解决方案 #

1. 注册后启用PhoneAccount #

在调用registerPhoneAccount后，添加启用账号的代码：

// 注册PhoneAccount后立即启用账号
telecomManager.setPhoneAccountEnabled(handle, true);

修改后的完整注册代码：

this.initializeTelecomManager();
String appName = this.getApplicationName(this.getAppContext());
PhoneAccount.Builder builder = new PhoneAccount.Builder(handle, appName)
        .setCapabilities(PhoneAccount.CAPABILITY_CALL_PROVIDER);

PhoneAccount account = builder.build();

telephonyManager = (TelephonyManager) this.getAppContext().getSystemService(Context.TELEPHONY_SERVICE);

telecomManager.registerPhoneAccount(account);
// 新增：启用当前PhoneAccount
telecomManager.setPhoneAccountEnabled(handle, true);

2. 确保Manifest配置正确 #

在AndroidManifest.xml中声明VoiceConnectionService组件，并添加必要权限：

<!-- 声明必要权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ANSWER_PHONE_CALLS" />
<uses-permission android:name="android.permission.MANAGE_OWN_CALLS" />

<!-- 注册VoiceConnectionService服务 -->
<service
    android:name=".VoiceConnectionService"
    android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
    <intent-filter>
        <action android:name="android.telecom.ConnectionService" />
    </intent-filter>
</service>

3. 申请动态权限 #

针对Android 6.0及以上版本，需要动态申请核心电话权限：

private static final int REQUEST_PHONE_PERMISSIONS = 1001;

// 检查并请求权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED
        || ContextCompat.checkSelfPermission(this, Manifest.permission.ANSWER_PHONE_CALLS) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.READ_PHONE_STATE, Manifest.permission.ANSWER_PHONE_CALLS},
            REQUEST_PHONE_PERMISSIONS);
}

验证 #

完成上述修改后，重新运行应用，调用模拟来电代码即可正常触发呼入请求，不再出现Phone Account Handle is not enabled for this user错误。

内容的提问来源于stack exchange，提问作者Shashwat Samadhiya