Pour la place de marché canonique, l'application mobile est le principal moyen d'interaction de l'utilisateur avec l'application.
Définir un cadran
Lorsque l'utilisateur sélectionne un cadran dans l'application pour téléphone, le flux suivant pour définir le cadran se compose de deux parties :
- Installation : installez la clock face à l'aide de Watch Face Push, lancé via
MessageClient
. Cette étape est simple. Elle utiliseaddWatchFace
ouupdateWatchFace
, déclenché à l'aide deMessageClient
du téléphone vers la montre. - Activation : définissez le cadran installé comme actif. Cette étape comporte plusieurs chemins possibles, selon l'état de l'autorisation :
- Aucune action n'est peut-être requise. Il est possible que la place de marché ait déjà le contrôle du 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()
. - Il peut être nécessaire de fournir des instructions, soit pour accepter les demandes d'autorisation, soit pour définir manuellement le cadran à l'aide d'un appui prolongé 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 au téléphone :
- Résultat de la tentative d'installation
- Résultat de
isWatchFaceActive()
pour déterminer si l'application possède déjà le cadran actif. - Indique 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 possède déjà le cadran actif. Toutefois, si ce n'est pas le cas, l'application peut choisir d'afficher un bouton Définir le cadran comme actif.
Scénario 1 : Toutes les tentatives de définition du cadran actif ont échoué
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'information sur le téléphone, lui montrant comment appuyer de manière prolongée sur le cadran de la montre 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, passez à l'appel de setWatchFaceAsActive().
- Si l'utilisateur a déjà refusé l'autorisation, la montre doit le communiquer au téléphone, où un écran pédagogique peut être affiché pour expliquer la nécessité de l'autorisation et comment l'accorder manuellement.
Si l'autorisation n'a pas été demandée auparavant, la montre doit demander au téléphone d'afficher un message expliquant à l'utilisateur comment accepter les autorisations sur la montre, puis la montre doit procéder à la demande d'autorisation.
- Si l'utilisateur accorde l'autorisation, la montre doit ensuite appeler
setWatchFaceAsActive()
. - Sinon, la montre doit demander au téléphone d'afficher un écran pédagogique expliquant la nécessité de l'autorisation et comment l'accorder manuellement.
- Si l'utilisateur accorde l'autorisation, la montre doit ensuite appeler