Zintegruj się z platformą Android Telecom za pomocą biblioteki Core-Telecom Jetpack, aby połączenia VoIP były traktowane przez system operacyjny jako podstawowa funkcja na równi z tradycyjnymi połączeniami opartymi na karcie SIM. Ta integracja ujednolica zarządzanie połączeniami, poprawia obsługę dźwięku i umożliwia zgodność z urządzeniami zdalnymi, takimi jak słuchawki i zegarki.
Wymagana implementacja
Aby kwalifikować się do programu AEP, aplikacja musi spełniać te wymagania:
- Rejestracja połączeń: wszystkie połączenia VoIP przychodzące i wychodzące muszą być rejestrowane w ramach Telecom za pomocą interfejsu CallsManager#addCall API.
- Zarządzanie stanem: używaj CallControlScope i innych konstrukcji biblioteki, aby dokładnie odzwierciedlać cykl życia stanu połączenia i nim zarządzać, w tym stanami wybierania, dzwonienia, aktywnego, wstrzymanego i rozłączonego.
- Obsługa dźwięku: nie używaj bezpośrednio interfejsów API Audio ani Bluetooth do zarządzania aktywnością audio i routingiem. Zamiast tego korzystaj z platformy Telecom, aby obsługiwać scenariusze jednoczesnych połączeń i zmiany urządzeń audio.
- Powiadomienia: użyj interfejsu callStyle API, aby wyświetlać powiadomienia w stylu połączeń, które są zgodne z systemem Android.
- Cykl życia usługi działającej na pierwszym planie: zarządzaj cyklem życia wszystkich niezbędnych usług działających na pierwszym planie w przypadku połączenia zgodnie ze sprawdzonymi metodami i ograniczeniami Androida.
- Integracja z urządzeniami zdalnymi: synchronizuje stan połączenia i elementy sterujące z podłączonymi urządzeniami zdalnymi, takimi jak słuchawki Bluetooth, urządzenia z Wear OS i Android Auto.
- Scenariusze wielu połączeń: płynna obsługa interakcji z innymi połączeniami, takimi jak połączenia przychodzące na kartę SIM lub połączenia z innych aplikacji VoIP, zapewniająca przewidywalne zachowanie dźwięku i wrażenia użytkownika.
Zakres obowiązywania wytycznych
Te wytyczne dotyczą:
- Aplikacje umożliwiają dzwonienie przez VoIP.
- Wszystkie formaty, w których aplikacja jest dostępna.
Wykluczenia
W przypadku tych wytycznych obowiązują te wyjątki:
- Aplikacje, które ze względu na bariery techniczne nie mogą korzystać z zależności AndroidX, np.:
- Konflikty zależności pakietu SDK
- Ograniczenia Projektu Android Open Source (AOSP)
- Ograniczenia systemu kompilacji producenta oryginalnego sprzętu (OEM)
- Tymczasowe zwolnienia mogą być przyznawane w przypadku aplikacji, w których występują poważne problemy z platformą lub biblioteką, które uniemożliwiają stabilną migrację, pod warunkiem że istnieje jasny harmonogram rozwiązania problemu i został on zaakceptowany przez Google.
- Aplikacje mogą korzystać z równoważnych alternatywnych platform, które zapewniają podobną jakość, funkcje dla użytkowników, stabilność i kompatybilność w całym ekosystemie. Jeśli masz odpowiednie ramy, które warto rozważyć, skontaktuj się z zespołem pomocy.
Dokumentacja i zasoby dotyczące funkcji
Poniższe materiały zawierają wskazówki dotyczące implementacji i szczegóły techniczne platformy Android Telecom Framework. Te materiały mają charakter wyłącznie informacyjny i nie zawierają dodatkowych wymagań programu.
- Tworzenie aplikacji do połączeń
- Omówienie platformy telekomunikacyjnej
- Integracja rejestru połączeń
- Zwiększanie widoczności aplikacji VoIP