Wraz z początkowym wprowadzeniem biblioteki Jetpack Telecom pojawił się CallsManager, który zastąpił starszy interfejs API ConnectionService, aby uprościć integrację VoIP. CallsManager usprawnia zarządzanie cyklem życia połączeń i routingiem dźwięku, umożliwiając jednocześnie interakcje z powierzchniami zdalnymi, takimi jak smartwatche, urządzenia Bluetooth i Android Auto. Dodatkowo obsługuje rozszerzenia połączeń, które zapewniają bogatsze funkcje, takie jak obsługa uczestników, niestandardowe ikony, wyciszanie połączeń i podsumowanie spotkania na powierzchniach zdalnych. Zachowuje przy tym zgodność wsteczną z Androidem O (poziom API 26).

W oparciu o te podstawy Jetpack Telecom w wersji 1.1.0 zapewnia natywną widoczność i wygodę w aplikacjach VoIP innych firm. Ta najnowsza wersja wprowadza nowe, zaawansowane funkcje, w tym ujednoliconą historię połączeń, wykluczanie połączeń z dziennika i natywną funkcję wywołania zwrotnego, dzięki czemu zarządzanie połączeniami jest dla użytkowników łatwiejsze niż kiedykolwiek.

Przyjrzyjmy się bliżej nowościom i sposobom implementacji tych funkcji w aplikacjach.

Wypełnianie luki w dialerze: ujednolicona historia połączeń i wywołania zwrotne

Do tej pory użytkownicy musieli otwierać poszczególne aplikacje innych firm, aby wyświetlić historię połączeń VoIP lub oddzwonić na nieodebrane połączenie. Dzięki nowej funkcji zintegrowanego rejestrowania połączeń aplikacje dialera systemowego mogą teraz wyświetlać dzienniki połączeń bezpośrednio z aplikacji VoIP innych firm.

Co więcej, użytkownicy mogą teraz inicjować wywołanie zwrotne do kontaktu VoIP bezpośrednio z natywnego dialera systemowego, co usprawnia komunikację.

Jak to działa:

Aby włączyć tę funkcję, wykonaj te czynności:

1. Zarejestruj wywołania zwrotne: Twoja aplikacja VoIP musi zarejestrować nową intencję chronioną przez system: TelecomManager.ACTION_CALL_BACK.
2. Zaloguj połączenie: użyj TelecomManager.addCall (lub powiązanych interfejsów API Jetpack), aby system automatycznie rejestrował połączenie.
3. Zarządzaj identyfikatorami połączeń: gdy połączenie jest zarejestrowane, CallControlScope.getCallId udostępnia unikalny identyfikator UUID. Dialer systemowy używa tego samego TelecomManager.EXTRA_UUID podczas tworzenia intencji wywołania zwrotnego.
4. Zainicjuj wywołanie zwrotne: Twoja aplikacja musi przechowywać szczegóły połączenia powiązane z tym identyfikatorem UUID i nimi zarządzać. Gdy dialer systemowy uruchomi intencję wywołania zwrotnego z EXTRA_UUID, Twoja aplikacja może bezproblemowo rozpoznać identyfikator i zainicjować połączenie z prawidłowymi szczegółami.

Szczegółowa kontrola: wykluczanie połączeń z dziennika

Zdajemy sobie sprawę, że nie wszystkie połączenia VoIP powinny być widoczne w historii natywnego dialera systemowego. Niezależnie od tego, czy chodzi o prywatność, komunikację efemeryczną czy zachowanie specyficzne dla aplikacji, musisz mieć kontrolę nad tym, co jest wyświetlane.

Aby to umożliwić, wprowadzamy wykluczanie połączeń z dziennika. Możesz teraz uniemożliwić rejestrowanie określonych połączeń w dziennikach połączeń systemowych, ustawiając wartość logiczną isLogExcluded na true w CallAttributesCompat. Po skonfigurowaniu tej flagi połączenie pozostaje całkowicie ukryte w dziennikach systemowych, a natywny dialer go nie wyświetla.

Ważna uwaga dotycząca zgodności

Te zintegrowane funkcje rejestrowania i wywoływania zwrotnego są dostępne na urządzeniach z Androidem 16.1 (SDK 36.1) lub nowszym. Tutaj znajdziesz informacje o kompilowaniu aplikacji za pomocą Android SDK 36.1.

Rozpocznij

Zachęcamy deweloperów do testowania tych integracji i sprawdzania, jak ujednolicona historia połączeń i wywołania zwrotne mogą poprawić codzienne wrażenia użytkowników aplikacji VoIP.

Aby ułatwić Ci rozpoczęcie i zobaczenie tych interfejsów API w działaniu, przygotowaliśmy przykładową aplikację, która demonstruje nowe integracje.

• Przykładowa aplikacja: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

Aby zacząć korzystać z tych funkcji, zapoznaj się z informacjami o wersji i dokumentacją.

Uwaga:: chociaż interfejsy API Jetpack Telecom w wersji 1.1.0 są dostępne do integracji, możliwość renderowania natywnych dzienników połączeń przez dialer systemowy jest wprowadzana etapami, począwszy od Google Meet. Aby chronić przed spamem, natywne dialery używają bezpiecznych list dozwolonych pakietów do kontrolowania wyświetlania VoIP. Do lokalnego testowania implementacji wywołań zwrotnych i rejestrowania zalecamy używanie aplikacji Telecom Sample Dialer z otwartym kodem źródłowym jako środowiska emulatora.