Configurer l'application de votre téléphone pour le transfert de cadran

Pour la place de marché canonique, l'application pour téléphone est le principal moyen par lequel l'utilisateur interagit avec l'application.

Définir un cadran

Lorsque l'utilisateur sélectionne un cadran dans l'application pour téléphone, le flux de paramétrage du cadran se compose de deux parties:

  1. Installation:installez le cadran à l'aide de la fonctionnalité Push de cadran, lancée via MessageClient. Cette étape est simple, que vous utilisiez addWatchFace ou updateWatchFace, déclenchée à l'aide de MessageClient du téléphone à la montre.
  2. Activation:définit le cadran installé comme actif. Cette étape comporte plusieurs chemins possibles, en fonction de l'état de l'autorisation :
    • Aucune action n'est requise. Il est possible que la place de marché contrôle déjà le cadran actif.
    • Aucune intervention de l'utilisateur n'est requise. L'application dispose des autorisations nécessaires pour définir le cadran actif et peut le faire directement à l'aide de setWatchFaceAsActive().
    • Des conseils peuvent être nécessaires, par exemple pour savoir comment accepter les demandes d'autorisation ou comment définir manuellement le cadran à l'aide d'un geste de pression prolongée ou via une application associée.

Réponse d'installation

Pour faciliter la phase d'activation, la phase d'installation doit renvoyer les informations suivantes de la montre vers le téléphone:

  • Résultat de la tentative d'installation
  • Résultat de isWatchFaceActive() : permet de déterminer si l'application dispose déjà du cadran actif.
  • Si setWatchFaceAsActive() a déjà été appelé par le passé, l'application Wear OS doit suivre et conserver ces informations localement. Cet appel d'API ne peut être utilisé qu'une seule fois.

Activation

Après l'installation, la réponse peut indiquer que l'application dispose déjà du cadran actif. Toutefois, si ce n'est pas le cas, l'application peut choisir d'afficher un bouton pour définir le cadran comme actif.

Scénario 1: Toutes les tentatives de définition du cadran actif sont épuisées

Si la réponse de l'installation indique que setWatchFaceAsActive() a déjà été appelé par le passé, le bouton doit rediriger l'utilisateur vers un écran d'instructions sur le téléphone, lui montrant comment appuyer de manière prolongée sur le cadran pour le définir manuellement sur celui de son choix.

Scénario 2 : Essayer de définir le cadran actif

Le téléphone doit demander à la montre de vérifier l'autorisation SET_PUSHED_WATCH_FACE_AS_ACTIVE nécessaire:

  • Si l'utilisateur l'a déjà accordée, appelez setWatchFaceAsActive().
  • Si l'utilisateur a déjà refusé l'autorisation, la montre doit le communiquer au téléphone, où un écran d'information peut s'afficher pour expliquer pourquoi cette autorisation est nécessaire et comment l'accorder manuellement.

  • Si l'autorisation n'a pas été demandée auparavant, la montre doit demander au téléphone de diffuser un moment pédagogique expliquant à l'utilisateur comment accepter les autorisations sur la montre, puis la montre doit demander l'autorisation.

    • Si l'utilisateur accorde l'autorisation, la montre doit appeler setWatchFaceAsActive().
    • Sinon, la montre doit demander au téléphone d'afficher un écran d'information expliquant pourquoi l'autorisation est nécessaire et comment l'accorder manuellement.