Creare app Wear OS per la Cina

Durante la creazione di app per Wear OS per la Cina, devi tenere conto degli smartphone senza Google Play sono preinstallati. Questa pagina contiene modifiche comuni che gli sviluppatori potrebbero dover adottare per il mercato cinese.

Utilizzare la versione corretta di Google Play Services

La versione 10.2.0 di Google Play Services fornisce supporto mondiale per l'API Fused Location Provider e l'API API Livello dati. Devi usare questa versione di Google Play Services se usi queste API per garantire il supporto di una gamma più ampia di dispositivi Wear OS in Cina. In altri casi, questa dipendenza è facoltativa.

Nota: anche se Google Play Services contiene API per le app Wear OS, le app Wear OS per la Cina dovrebbero continuare a utilizzare le API relative a GoogleApiClient. Consulta Accedere all'API Wearable.

API Fused Location Provider

Se utilizzi l'API Fused Location Provider, includi la seguente dipendenza nel file build.gradle del tuo modulo Wear OS:

Alla modaKotlin

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

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

API Data Layer

Nota: l'API Data Layer può inviare messaggi e sincronizzare i dati solo con smartphone Android. e smartwatch Wear OS. Se il tuo dispositivo Wear OS è accoppiato a un dispositivo iOS, i dati L'API Layer non funziona.

Per questo motivo, non utilizzare l'API del livello dati come modo principale per comunicare con una rete. Segui invece lo stesso schema nell'app per Wear OS come in un'app mobile, con alcune piccole differenze come descritto in Accesso alla rete e sincronizzazione su Wear OS.

Se la tua app utilizza l'API Data Layer, devi aggiungere la riga seguente al build.gradle file del tuo modulo Wear OS. La riga richiede l'utilizzo della versione 10.2.0 della libreria client.

Alla modaKotlin

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

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

Aggiungi la seguente riga al file build.gradle di modulo sul tuo dispositivo mobile. Sostituisci la dipendenza di Google Play Services con un riferimento alla Versione 10.2.0.

GroovyKotlin

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

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

Autenticazione

Prima di implementare l'autenticazione, esamina i casi d'uso per verificare se è effettivamente necessaria. Ad esempio, per un'app che fornisce le previsioni meteo, probabilmente non è necessario accedere e quindi autenticarsi.

Se richiedi l'autenticazione, ti consigliamo di utilizzare la libreria AndroidX OAuth. Per farlo, è necessario utilizzare il flusso Concessione del codice di autorizzazione con PKCE. Puoi anche utilizzare uno degli altri metodi descritti in Autenticazione sugli indossabili. L'uso della libreria di supporto per dispositivi indossabili non è consigliato.

Per maggiori informazioni, consulta l'esempio OAuth per Wear OS su GitHub.

Notifiche collegate

Le notifiche collegate non sono supportate in Cina. Le notifiche dello smartphone sono collegate a Wear OS solo se il dispositivo Wear OS è connesso al telefono tramite Bluetooth.

Compatibilità delle coordinate di posizione e mappatura

Utilizza la FusedLocationProvider (FLP) per rilevare la posizione dell'utente in Cina, come si farebbe per il resto del mondo. In questo modo, la tua app prende in considerazione le informazioni migliori, indipendentemente dall'hardware dello smartwatch e dalla piattaforma dello smartphone a cui è accoppiato. L'utilizzo del FLP aggiunge anche l'ottimizzazione della batteria integrata nella piattaforma Wear OS.

Quando integri FusedLocationProvider con SDK di mappe di terze parti, tieni conto della compatibilità delle coordinate tra i fornitori. FusedLocationProvider registra la posizione in base allo standard WGS84. Assicurati di convertire i sistemi di coordinate, se necessario.

Assistenza di Google Fit

In Cina sono supportati in Google Fit il contapassi accumulato, i minuti di movimento e i punti cardio, con fino a sette giorni di cronologia. Puoi accedere senza fornire una credenziale utente.

Supporto delle azioni vocali

La piattaforma Wear OS fornisce diversi intent vocali basati sulle azioni dell'utente, ad esempio _"Mostra battito cardiaco"_ o _"Imposta una sveglia"_. In questo modo gli utenti possono dire cosa vogliono fare e il sistema a capire qual è l'attività migliore da iniziare.

Quando gli utenti pronunciano un'azione vocale, la tua app può filtrare in base all'intent che viene attivato per avviare un attività. Per avviare un servizio in background, mostra un'attività come suggerimento visivo e avvia la servizio nell'attività. Assicurati di chiamare finish() per rimuovere l'indicatore visivo.

Di seguito è riportato un elenco delle intenzioni vocali supportate dalla piattaforma Wear OS:

Categoria	Esempio	Specifiche di intent
Chiamate di auto	打车去三里屯	Azione com.google.android.gms.actions.RESERVE_TAXI_RESERVATION Extra to: la destinazione riconosciuta L'extra è facoltativo.
Imposta sveglia	设元闹钟 明早七点的闹钟	Azione android.intent.action.SET_ALARM Extra android.provider.AlarmClock.EXTRA_HOUR: un numero intero con l'ora della sveglia android.provider.AlarmClock.EXTRA_MINUTES: un numero intero con il minuto della sveglia Questi extra sono facoltativi. Fornisci una di queste opzioni, entrambe o nessuna di queste.
Imposta il timer	设置一个三分钟的倒计时	Azione android.intent.action.SET_TIMER Extra android.provider.AlarmClock.EXTRA_LENGTH: un numero intero compreso tra 1 e 86400 (il numero di secondi in 24 ore), che rappresenta la durata del timer
Avvia cronometro	开始计时	Azione com.google.android.wearable.action.STOPWATCH
Avviare o interrompere una corsa in bici	开始骑车	Azione vnd.google.fitness.TRACK Tipo MIME vnd.google.fitness.activity/biking Extra actionStatus: una stringa con il valore ActiveActionStatus all'avvio e CompletedActionStatus all'arresto
Avviare o interrompere una corsa	开始跑步	Azione vnd.google.fitness.TRACK Tipo MIME vnd.google.fitness.activity/running Extra actionStatus: una stringa con il valore ActiveActionStatus all'avvio e CompletedActionStatus all'arresto
Avviare o interrompere un esercizio	开始锻炼	Azione vnd.google.fitness.TRACK Tipo MIME vnd.google.fitness.activity/other Extra actionStatus: una stringa con il valore ActiveActionStatus all'avvio e CompletedActionStatus all'arresto
Mostra battito cardiaco	查看조率	Azione vnd.google.fitness.VIEW Tipo MIME vnd.google.fitness.data_type/com.google.heart_rate.bpm
Mostra numero di passi	查看步数	Azione vnd.google.fitness.VIEW Tipo MIME vnd.google.fitness.data_type/com.google.step_count.cumulative
Navigazione	导航去三里屯	Azione android.intent.action.VIEW Dati geo:latitude,longitude?q=融科资讯中心

L'assistente vocale può anche utilizzare gli intent comuni di Android esistenti per attivare determinati comportamenti, se applicabili.

Supporto dell'emulatore

Puoi utilizzare la versione cinese dell'immagine dell'emulatore Wear OS per testare le tue app. Questo è supportata da Android Studio 3.0 e versioni successive.

Per testare le tue app sulla versione cinese dell'emulatore, segui questi passaggi:

1. Installa l'emulatore Android.
2. Scarica le immagini Wear OS per la Cina dal gestore SDK. Utilizzare la versione per Wear OS 3.5 (livello API 30).
3. Scegli l'immagine Wear OS per la Cina quando crei un profilo di visualizzazione di video.
4. Esegui l'emulatore Wear OS per la Cina per lo sviluppo.


Figura 1. Esempi della versione cinese dell'emulatore Wear OS.

Questa versione dell'emulatore Wear OS include diverse app preinstallate:

• Modalità Ambient
• Contatti
• Google Scrittura a mano libera
• Google Play Services
• Servizi sanitari per Wear OS
• Riconoscimento hotword per i dispositivi LE
• Pinyin
• Play Store (adattato per i dispositivi in Cina)
• Orologio da taschino
• TalkBack
• Quadranti (versioni analogiche e digitali)
• Servizi principali di Wear

Avviare un canale Bluetooth e Wi-Fi specifico dell'app

Wear OS instrada automaticamente le richieste di rete. Nella maggior parte dei casi, non è necessario che l'app apra un canale Bluetooth e Wi-Fi specifico per l'app.

Se un'app richiede un canale Bluetooth e Wi-Fi specifico per l'app in Cina, la richiesta in modo automatico. Viene invece visualizzata una finestra di dialogo chiedendo conferma all'utente. Se l'utente conferma, il canale si apre. Questo accade ogni volta, non solo al primo utilizzo. BluetoothAdapter.enable() o WifiManager.setEnabled(true) è chiamato.

Nota: per il targeting per app Android 10 (livello API 29) o versioni successive per chiamare WifiManager.setEnabled(), deve essere un'app di sistema o un controller dei criteri dei dispositivi (DPC).

Modalità di revisione delle autorizzazioni

In Cina, i dispositivi Wear OS per la Cina funzionano in modalità di revisione delle autorizzazioni, che impone alcuni limiti sulle modalità di utilizzo delle app con un valore targetApiLevel inferiore a 23. Esamina i seguenti limiti:

• Anche se le autorizzazioni vengono concesse al momento dell'installazione, quando un'app con un valore di targetApiLevel inferiore a 23 viene avviata per la prima volta, viene visualizzata una finestra di dialogo che chiede all'utente di confermare le autorizzazioni per l'app.
• Componenti dell'app, ad esempio broadcast receiver, servizi e attività non rispondono agli eventi corrispondenti prima che l'app venga usata per la prima volta.

Di conseguenza, ti consigliamo di usare targetApiLevel 23 o versioni successive e adottare autorizzazioni app di Google Cloud.

Utilizzare altre API di Google Play Services

Se la tua app utilizza API Google Play Services diverse dall'API Wearable, la tua app deve verificare se queste API possono essere usate durante il runtime e rispondono in modo appropriato. Esistono due modi per verificare la disponibilità delle API di Google Play Services:

1. Utilizza un'istanza GoogleApiClient separata per connetterti ad altre API. Questa interfaccia contiene callback per avvisa la tua app dello operazione riuscita o errore della connessione. In caso di connessione non riuscita, ConnectionResult mostra API_UNAVAILABLE. Per scoprire come gestire gli errori di connessione, consulta Accedere alle API Google.
2. Utilizza la addApiIfAvailable() di GoogleApiClient.Builder per connetterti alle API richieste. Dopo l'attivazione del callback onConnected(), utilizza il metodo hasConnectedApi() per assicurarti che ciascuna delle API richieste sia collegata correttamente.

Distribuire app in Cina

Per raggiungere efficacemente gli utenti di Wear OS per la Cina, puoi distribuire tramite store per Wear OS di terze parti come i seguenti:

• Galaxy Store per i dispositivi Samsung
• Xiaomi Store per i dispositivi Xiaomi
• Mobvoi per tutti gli altri dispositivi