تغییر مسیر یک تماس

دستگاه‌هایی که Android 10 یا بالاتر دارند، هدف تماس را متفاوت از دستگاه‌هایی که Android 9 یا پایین‌تر دارند، مدیریت می‌کنند. در 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()
            }
        }
    }
}

جاوا

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

شما باید این سرویس را در مانیفست ثبت کنید تا سیستم بتواند آن را به درستی راه اندازی کند.

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

جاوا

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