Tworzenie aplikacji na Wear OS dla Chin

Tworząc aplikacje na Wear OS przeznaczone do Chin, musisz uwzględnić telefony bez Google Play fabrycznie zainstalowanych usług. Ta strona zawiera typowe zmiany, których deweloperzy mogą być zmuszeni do wprowadzenia rynku chińskiego.

Używanie prawidłowej wersji Usług Google Play

Usługi Google Play w wersji 10.2.0 dają pomoc na całym świecie Fused Location Provider API oraz Interfejs API warstwy danych. Jeśli używasz tych interfejsów API, musisz używać tej wersji Usług Google Play zapewnić obsługę szerszej gamy urządzeń z Wear OS w Chinach. W innych przypadkach zależność ta opcjonalnie.

Uwaga: Usługi Google Play zawierają Interfejsy API dla aplikacji na Wear OS (aplikacje na Wear OS w Chinach powinny być nadal dostępne) używać interfejsów API związanych z zasadą GoogleApiClient; zobacz . Uzyskaj dostęp do interfejsu Wearable API.

Interfejs Fused Location Provider API

Jeśli używasz interfejsu Fused Location Provider API, uwzględnij tę zależność w plik build.gradle modułu Wear OS:

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-location:10.2.0'
}

dependencies {
    ...
    implementation("com.google.android.gms:play-services-location:10.2.0")
}

Interfejs API warstwy danych

Jeśli Twoja aplikacja używa interfejsu Data Layer API, musisz dodać ten wiersz do Plik build.gradle modułu Wear OS. Ten wiersz wymaga użycia wersji 10.2.0 z biblioteki klienta.

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
    ...
}

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
    ...
}

Dodaj ten wiersz do pliku build.gradle do modułu mobilnego. Zastąp zależność Usług Google Play odwołaniem do elementu wersji 10.2.0.

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
}

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
}

Uwierzytelnianie

Przed wdrożeniem uwierzytelniania przejrzyj przypadki użycia i sprawdź, czy uwierzytelnianie niezbędną. Na przykład w aplikacji dostarczającej prognozę pogody prawdopodobnie nie trzeba logowania, a tym samym do uwierzytelniania.

Jeśli wymagasz uwierzytelniania, zalecamy użycie Biblioteka Oauth AndroidaX Wymaga to korzystania z Proces przyznania kodu autoryzacji z PKCE. Możesz też użyć jednej z innych metod opisanych w artykule Uwierzytelnianie na urządzeniach do noszenia. Nie zalecamy korzystania z Biblioteki pomocy do noszenia.

Więcej informacji: Przykładowy protokół OAuth z Wear OS w GitHubie.

Powiadomienia mostkowane

Powiadomienia mostowe nie są obsługiwane w Chinach. Powiadomienia z telefonu są powiązane z Wear OS tylko wtedy, gdy urządzenie z Wear OS jest połączone z telefonem przez Bluetooth.

Zgodność lokalizacji i współrzędnych map

Należy użyć funkcji FusedLocationProvider (FLP), aby wykryć lokalizację użytkownika w Chinach – tak jak dla reszty świata. Dzięki temu aplikacja bierze pod uwagę najlepsze informacje niezależnie od modelu zegarka i platformy telefonu, z którą jest sparowany zegarek. Korzystanie z FLP zapewnia też optymalizację baterii wbudowaną w platformę Wear OS.

Podczas integracji FusedLocationProvider z pakietami SDK map innych firm uwzględnia zgodność współrzędnych między dostawcami. FusedLocationProvider zgłasza lokalizację na podstawie Standard WGS84. Pamiętaj, by odpowiednio przekonwertować układy współrzędnych.

Pomoc Google Fit

Google Fit licznik kroków, minuty ruchu i punkty kardio są obsługiwane w Chinach. 7 dni historii. Możesz uzyskać do niego dostęp bez podawania danych logowania użytkownika.

Obsługa komend głosowych

Platforma Wear OS udostępnia kilka intencji głosowych opartych na działaniach użytkownika, np. _"Pokaż tętno"_ lub _"Ustaw alarm"_. Dzięki temu użytkownicy mogą powiedzieć, co chcą zrobić, a system określić najlepszą aktywność na początek.

Gdy użytkownik wypowiada komendę głosową, aplikacja może filtrować wyniki pod kątem wywołanego intencji, działania. Aby uruchomić usługę w tle, wyświetl aktywność jako sygnał wizualny i uruchom polecenie w ramach aktywności. Zadzwoń pod numer finish(), by pozbyć się sygnału wizualnego.

Oto lista intencji głosowych obsługiwanych przez platformę Wear OS:

Asystent głosowy może też używać Typowe intencje Androida w odpowiednich przypadkach wywoływać określone zachowania.

Obsługa emulatora

Do testowania aplikacji możesz użyć chińskiej wersji obrazu emulatora Wear OS. Ten jest obsługiwana przez Androida Studio 3.0 lub nowszego.

Aby przetestować aplikacje emulatora w chińskiej wersji, wykonaj te czynności:

1. Zainstaluj emulator Androida.
2. Pobierz obrazy z Wear OS (Chiny) z menedżera pakietów SDK. Używaj wersji Wear OS 3.5 (poziom API 30).
3. Podczas tworzenia profilu AVD wybierz obraz z Wear OS dla Chin.
4. Na potrzeby programowania możesz uruchomić emulator Wear OS dla Chin.


Rysunek 1. Przykłady chińskiej wersji emulatora Wear OS.

Ta wersja emulatora Wear OS ma kilka wstępnie zainstalowanych aplikacji:

• Dźwięki otoczenia
• Kontakty
• Pismo odręczne Google
• Usługi Google Play
• Usługi zdrowotne na Wear OS
• Rozpoznawanie słów-kluczy na urządzeniach LE
• Pinyin
• Sklep Play (dostosowane do urządzeń w Chinach)
• Zegarek kieszonkowy
• TalkBack
• Tarcze (zarówno analogowe, jak i cyfrowe)
• Usługi podstawowe Wear

Inicjowanie kanału Bluetooth i Wi-Fi dla określonej aplikacji

Wear OS automatycznie kieruje żądania sieciowe. W większości przypadków nie trzeba , by aplikacja otworzyła własny kanał Bluetooth i Wi-Fi.

Jeśli aplikacja poprosi o połączenie kanału Bluetooth i Wi-Fi związanego z aplikacją w Chinach, żądanie: po cichu zawiedzie. Zamiast tego pojawi się okno proszą użytkownika o potwierdzenie. Jeśli użytkownik wyrazi zgodę, kanał zostanie otwarty. Zdarza się to co o czasie, a nie tylko przy pierwszym użyciu. BluetoothAdapter.enable() lub WifiManager.setEnabled(true) to .

Uwaga: w przypadku kierowania na aplikację Android 10 (poziom interfejsu API 29) lub nowszy WifiManager.setEnabled(), musi to być aplikacja systemowa lub kontroler zasad dotyczących urządzeń (DPC).

Tryb sprawdzania uprawnień

W Chinach Wear OS dla urządzeń z Chin działa w trybie sprawdzania uprawnień, nakłada pewne ograniczenia na sposób korzystania z aplikacji z targetApiLevel poniżej 23. Sprawdź te limity:

• Mimo że uprawnienia są przyznawane w momencie instalacji, gdy aplikacja z tagiem Po raz pierwszy zostanie uruchomiona wartość targetApiLevel mniejsza niż 23. Pojawi się okno z pytaniem użytkownik powinien potwierdzić uprawnienia dla tej aplikacji.
• elementy aplikacji, takie jak odbiorniki, usługi i działania; nie reagują na odpowiednie zdarzenia przed użyciem aplikacji po raz pierwszy.

Dlatego zalecamy korzystanie z targetApiLevel w wersji 23 lub nowszej i wdrożyć uprawnienia aplikacji sprawdzone metody.

Używanie innych interfejsów API Usług Google Play

Jeśli Twoja aplikacja używa interfejsów API Usług Google Play innych niż Wearable API, aplikacja musi sprawdzić, te interfejsy API są dostępne do użytku w czasie działania i odpowiednio na nie reagują. Dostępność interfejsów API usługi Google Play możesz sprawdzić na 2 sposoby:

1. Użyj oddzielnej instancji GoogleApiClient do łączenia się z innymi interfejsami API. Ten interfejs zawiera wywołania zwrotne do powiadamiaj aplikację o sukces lub może wystąpić błąd połączenia. W przypadku nieudanego połączenia ConnectionResult pokazuje API_UNAVAILABLE. Aby dowiedzieć się, jak postępować w przypadku błędów połączenia, zapoznaj się z sekcją Dostęp do interfejsów API Google
2. Korzystanie z addApiIfAvailable() GoogleApiClient.Builder, aby połączyć się z wymaganymi interfejsami API. Po onConnected() uruchomi się wywołanie zwrotne, użyj hasConnectedApi(), aby zapewnić prawidłowe połączenie każdego żądanego interfejsu API.

Dystrybucja aplikacji w Chinach

Aby skutecznie docierać do użytkowników Wear OS w Chinach, możesz rozpowszechniać sklepów z aplikacjami na Wear OS innych firm, takich jak:

• Galaxy Store na urządzeniach Samsung
• Sklep Xiaomi na urządzenia Xiaomi
• Mobvoi w przypadku wszystkich pozostałych urządzeń.