텔레콤 프레임워크 개요

Android 텔레콤 프레임워크('통신'이라고도 함)는 Android 지원 기기의 음성 및 영상 통화를 관리합니다. 여기에는 텔레포니 프레임워크를 사용하는 통화와 같은 SIM 기반 통화와 ConnectionService API를 구현하는 VoIP 호출이 포함됩니다.

Telecom이 관리하는 주요 구성요소는 ConnectionServiceInCallService입니다.

ConnectionService 구현은 VoIP와 같은 기술을 사용하여 통화를 다른 당사자에 연결합니다. 휴대전화에서 가장 일반적인 ConnectionService 구현은 전화 통신 ConnectionService입니다. 이동통신사 이용 통화를 연결해 줍니다.

InCallService 구현은 텔레콤에서 관리하는 통화에 사용자 인터페이스를 제공하고 사용자가 이러한 통화를 제어하고 상호작용할 수 있도록 합니다. InCallService의 가장 일반적인 구현은 기기와 번들로 제공되는 전화 앱입니다.

통신은 스위치보드 역할을 합니다. ConnectionService 구현에서 제공하는 통화를 InCallService 구현에서 제공하는 호출 사용자 인터페이스로 라우팅합니다.

다음과 같은 이유로 Telecom API를 구현할 수 있습니다.

대체 전화 앱 만들기

Android 기기에서 기본 전화 앱의 대체 앱을 만들려면 InCallService API를 구현합니다. 구현은 다음 요구사항을 충족해야 합니다.

  • 통화 기능이 없어야 하며 호출을 위한 사용자 인터페이스로만 구성되어야 합니다.
  • 또한 텔레콤 프레임워크가 인식하는 모든 통화를 처리해야 하며 통화의 성격을 가정해서는 안 됩니다. 예를 들어 통화가 SIM 기반 전화 통신 통화라고 가정하거나 하나의 ConnectionService에 기반한 통화 제한을 구현해서는 안 됩니다(예: 영상 통화에 대한 전화 통신 제한 적용).

자세한 내용은 InCallService를 참고하세요.

통화 솔루션 통합

통화 솔루션을 Android에 통합하려면 다음 옵션을 사용할 수 있습니다.

  • 자체 관리 ConnectionService API 구현: 이 옵션은 기본 전화 앱 내에서 통화를 표시하거나 사용자 인터페이스에 다른 통화가 표시되지 않기를 원하는 독립형 통화 앱 개발자에게 적합합니다.

    자체 관리 ConnectionService를 사용하면 앱이 기기의 기본 전화 통신 호출뿐만 아니라 이 API를 구현하는 다른 독립형 통화 앱과도 상호 운용될 수 있습니다. 자체 관리형 ConnectionService API는 오디오 라우팅 및 포커스도 관리합니다. 자세한 내용은 통화 앱 빌드를 참고하세요.

  • 관리형 ConnectionService API 구현: 이 옵션은 기존 기기 휴대전화 애플리케이션을 사용하여 통화용 사용자 인터페이스를 제공하는 통화 솔루션의 개발을 용이하게 합니다. 예를 들어 SIP 통화 및 VoIP 통화 서비스의 서드 파티 구현을 들 수 있습니다. 자세한 내용은 getDefaultDialerPackage()를 참조하세요.

    ConnectionService만으로는 통화를 연결하는 수단만 제공됩니다. 연결된 사용자 인터페이스가 없습니다.

  • InCallService 및 ConnectionService API 모두 구현: 이 옵션은 자체 ConnectionService 기반 통화 솔루션을 만들고, 자체 사용자 인터페이스를 완성하고, 다른 모든 Android 통화도 동일한 사용자 인터페이스에 표시하려는 경우에 적합합니다. 이 접근 방식을 사용할 때 InCallService 구현은 표시되는 호출의 소스를 가정해서는 안 됩니다. 또한 기본 전화 앱을 맞춤 InCallService로 설정하지 않아도 ConnectionService 구현이 계속 작동해야 합니다.

통화 선택

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

respondToCall()를 호출하도록 onScreenCall() 함수를 설정하여 새 호출에 응답하는 방법을 시스템에 알립니다. 이 함수는 호출을 차단하거나, 사용자가 한 것처럼 거부하거나, 음소거하도록 시스템에 지시하는 데 사용할 수 있는 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 구현을 등록해야 합니다.

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

전화 리디렉션

Android 10 이상을 실행하는 기기는 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();
        }
    }
}

매니페스트에 이 서비스를 등록해야 시스템이 올바르게 시작할 수 있습니다.

<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로 만든 인텐트를 실행하므로 사용자의 선택을 처리하도록 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);
            }
        }
    }
}