Integracja z usługą TelecomManager
W tym dokumencie opisano sposób integracji programu TelecomManager z aplikacją systemu Android.
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
- Wdrożony zasób usług komunikacyjnych. Utwórz zasób usług komunikacyjnych.
- Token dostępu użytkownika umożliwiający włączenie klienta wywołującego. Aby uzyskać więcej informacji, zobacz Tworzenie tokenów dostępu i zarządzanie nimi.
- Opcjonalnie: ukończ przewodnik Szybki start, aby dodać połączenie głosowe do aplikacji
Integracja z usługą TelecomManager
Ważne
Ta funkcja usług Azure Communication Services jest obecnie dostępna w wersji zapoznawczej.
Interfejsy API i zestawy SDK w wersji zapoznawczej są udostępniane bez umowy dotyczącej poziomu usług. Zalecamy, aby nie używać ich w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości.
Aby uzyskać więcej informacji, zapoznaj się z dodatkowymi warunkami użytkowania dla wersji zapoznawczych platformy Microsoft Azure.
TelecomManager
Integracja z zestawem SDK systemu Android usług Azure Communication Services obsługuje interakcję z innymi aplikacjami voIP i PSTN wywołującymi aplikacje, które są również zintegrowane z usługą TelecomManager
.
Skonfigurować TelecomConnectionService
Dodawanie TelecomConnectionService
do aplikacji AndroidManifest.xml
<application>
...
<service
android:name="com.azure.android.communication.calling.TelecomConnectionService"
android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE"
android:exported="true">
<intent-filter>
<action android:name="android.telecom.ConnectionService" />
</intent-filter>
</service>
</application>
Inicjowanie agenta połączeń za pomocą programu TelecomManagerOptions
W przypadku skonfigurowanego TelecomManagerOptions
wystąpienia programu możemy utworzyć element z włączonym TelecomManager
ustawieniem CallAgent
.
CallAgentOptions options = new CallAgentOptions();
TelecomManagerOptions telecomManagerOptions = new TelecomManagerOptions("<your app's phone account id>");
options.setTelecomManagerOptions(telecomManagerOptions);
CallAgent callAgent = callClient.createCallAgent(context, credential, options).get();
Call call = callAgent.join(context, locator, joinCallOptions);
Konfigurowanie urządzenia wyjściowego audio
Po włączeniu integracji usługi TelecomManager dla aplikacji urządzenie wyjściowe audio musi być wybrane tylko za pośrednictwem interfejsu API menedżera telekomunikacyjnego.
call.setTelecomManagerAudioRoute(android.telecom.CallAudioState.ROUTE_SPEAKER);
Konfigurowanie zachowania wznawiania wywołań
Gdy wywołanie zostanie przerwane z innym wywołaniem, na przykład przychodzące wywołanie PSTN, wywołanie ACS zostanie umieszczone OnHold
. Możesz skonfigurować to, co się stanie, gdy wywołanie PSTN zostanie automatycznie wznowione, lub poczekać na żądanie wznowienia wywołania przez użytkownika.
telecomManagerOptions.setResumeCallAutomatically(true);