W pierwszej wersji biblioteki Jetpack Telecom wprowadzono CallsManager, która zastąpiła starszy interfejs API ConnectionService, aby uprościć integrację VoIP. CallsManager upraszcza zarządzanie cyklem życia połączeń i kierowanie dźwięku, a także umożliwia interakcje z urządzeniami zdalnymi, takimi jak smartwatche, urządzenia Bluetooth i Android Auto. Obsługuje też rozszerzenia połączeń, które zapewniają bogatsze funkcje, takie jak obsługa uczestników, niestandardowe ikony, wyciszanie połączeń i podsumowanie spotkania na urządzeniach zdalnych, przy zachowaniu zgodności wstecznej z Androidem O (poziom API 26).

Jetpack Telecom w wersji 1.1.0 zapewnia aplikacjom VoIP innych firm widoczność i wygodę na poziomie natywnym. Ta najnowsza wersja wprowadza nowe, zaawansowane funkcje, w tym ujednoliconą historię połączeń, wykluczanie dzienników połączeń i natywną funkcję oddzwaniania, dzięki czemu zarządzanie połączeniami jest dla użytkowników łatwiejsze niż kiedykolwiek wcześniej.

Przyjrzyjmy się bliżej nowościom i sprawdźmy, jak możesz wdrożyć te funkcje w swoich aplikacjach.

Wypełnianie luki w aplikacji Telefon: ujednolicona historia połączeń i oddzwanianie

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 zintegrowanej funkcji rejestrowania połączeń aplikacje systemowe do wybierania numerów mogą teraz wyświetlać dzienniki połączeń bezpośrednio z aplikacji VoIP innych firm.

Co więcej, użytkownicy mogą teraz inicjować połączenie zwrotne z kontaktem VoIP bezpośrednio z natywnej aplikacji do wybierania numerów, co usprawnia komunikację.

Jak to działa:

Aby włączyć tę funkcję:

1. Rejestracja wywołań zwrotnych: aplikacja VoIP musi zarejestrować nowy chroniony przez system zamiar: TelecomManager.ACTION_CALL_BACK.
2. Zarejestruj połączenie: użyj TelecomManager.addCall (lub powiązanych interfejsów Jetpack API), aby system automatycznie rejestrował połączenie.
3. Zarządzanie identyfikatorami połączeń: gdy połączenie zostanie zarejestrowane, CallControlScope.getCallId udostępnia unikalny identyfikator UUID. Podczas tworzenia intencji wywołania zwrotnego dialer systemowy używa dokładnie tego parametru TelecomManager.EXTRA_UUID.
4. Zainicjuj wywołanie zwrotne: aplikacja musi przechowywać szczegóły połączenia powiązane z tym identyfikatorem UUID i nimi zarządzać. Gdy systemowy dialer wywoła intencję wywołania zwrotnego z parametrem EXTRA_UUID, Twoja aplikacja może bezproblemowo rozpoznać identyfikator i rozpocząć połączenie z prawidłowymi danymi.

Szczegółowa kontrola: wykluczanie rejestru połączeń

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

Aby rozwiązać ten problem, wprowadzamy wykluczanie dziennika połączeń. Możesz teraz zapobiegać rejestrowaniu określonych połączeń w systemowych dziennikach połączeń, ustawiając wartość logiczną isLogExcluded na true w CallAttributesCompat. Skonfigurowanie tego flagi spowoduje, że połączenie pozostanie całkowicie ukryte w dziennikach systemowych, a natywny dialer nie będzie go 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. Aby skompilować aplikację za pomocą pakietu Android SDK w wersji 36.1, zapoznaj się z informacjami tutaj.

Rozpocznij

Zachęcamy deweloperów do przetestowania tych integracji i sprawdzenia, jak ujednolicona historia połączeń i oddzwanianie mogą poprawić codzienne wrażenia użytkowników aplikacji VoIP.

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

• Przykładową aplikację znajdziesz tutaj: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

Zapoznaj się z informacjami o wersji i dokumentacją, aby zacząć wdrażać te funkcje już dziś.

Uwaga: interfejsy Jetpack Telecom w wersji 1.1.0 są dostępne do integracji, ale możliwość renderowania natywnych logów połączeń przez dialer systemowy jest wprowadzana etapami, począwszy od Google Meet. Aby chronić użytkowników przed spamem, natywne aplikacje do wybierania numerów korzystają z bezpiecznych list dozwolonych pakietów, które kontrolują wyświetlanie połączeń VoIP. Do lokalnego testowania implementacji wywołania zwrotnego i rejestrowania zalecamy używanie aplikacji Telecom Sample Dialer o otwartym kodzie źródłowym jako środowiska emulatora.