Configurare l'app dello smartphone per i quadranti push

Per il marketplace canonico, l'app per smartphone è il modo predominante in cui l'utente interagisce con l'app.

Impostare un quadrante

Quando l'utente seleziona un quadrante nell'app per smartphone, il flusso successivo per impostarlo è composto da due parti:

  1. Installazione: installa il quadrante utilizzando la funzionalità Push dei quadranti, avviata tramite MessageClient. Questo passaggio è semplice, puoi usare addWatchFace o updateWatchFace, attivato usando MessageClient dallo smartphone allo smartwatch.
  2. Attivazione: imposta il quadrante installato come attivo. Questo passaggio ha diversi percorsi possibili, a seconda dello stato dell'autorizzazione:
    • Potrebbe non essere richiesta alcuna azione. Il marketplace potrebbe già avere il controllo del quadrante attivo.
    • Potrebbe non essere necessario alcun intervento da parte dell'utente. L'app dispone delle autorizzazioni necessarie per impostare il quadrante attivo e può farlo direttamente utilizzandosetWatchFaceAsActive().
    • Potrebbero essere necessarie indicazioni su come accettare le richieste di autorizzazione o su come impostare manualmente il quadrante utilizzando un gesto di pressione prolungata o un'app complementare.

Risposta all'installazione

Per facilitare la fase di attivazione, la fase di installazione deve restituire le seguenti informazioni dallo smartwatch allo smartphone:

  • Il risultato del tentativo di installazione
  • Il risultato di isWatchFaceActive() per determinare se l'app ha già il quadrante attivo.
  • Se setWatchFaceAsActive() è già stato chiamato in passato, l'app Wear OS dovrebbe monitorare e mantenere queste informazioni in locale. Questa chiamata API può essere utilizzata solo una volta.

Attivazione

Dopo l'installazione, la risposta potrebbe indicare che l'app ha già il quadrante attivo. Tuttavia, se non lo fa, l'app potrebbe scegliere di mostrare un pulsante per impostare il quadrante come attivo.

Scenario 1: tutti i tentativi di impostare il quadrante attivo sono stati esauriti

Se la risposta dell'installazione ha indicato che setWatchFaceAsActive() è stato già chiamato in passato, il pulsante dovrebbe aprire una schermata informativa sullo smartphone che mostra all'utente come toccare e tenere premuto il quadrante per impostarlo manualmente su quello che preferisce.

Scenario 2: prova a impostare il quadrante attivo

Lo smartphone dovrebbe chiedere allo smartwatch di verificare l'autorizzazione SET_PUSHED_WATCH_FACE_AS_ACTIVE necessaria:

  • Se l'utente lo ha già concesso, procedi chiamando setWatchFaceAsActive().
  • Se l'utente ha negato l'autorizzazione in precedenza, lo smartwatch dovrebbe comunicarlo allo smartphone, dove può essere visualizzata una schermata informativa che spiega la necessità dell'autorizzazione e come concederla manualmente.

  • Se l'autorizzazione non è stata richiesta in precedenza, lo smartwatch dovrebbe invitare lo smartphone a mostrare un momento formativo che indichi all'utente come accettare le autorizzazioni sullo smartwatch, che a sua volta dovrebbe procedere con la richiesta.

    • Se l'utente concede l'autorizzazione, lo smartwatch deve chiamaresetWatchFaceAsActive().
    • In caso contrario, lo smartwatch dovrebbe chiedere allo smartphone di mostrare una schermata informativa che spiega la necessità dell'autorizzazione e come concederla manualmente.