Depuis la version 2, le format de cadran prend en charge les données météorologiques. Ces données couvrent un éventail de métriques et de périodes, des conditions actuelles aux prévisions horaires et quotidiennes.
La météo est accessible à l'aide d'expressions. Par exemple, pour afficher l'état actuel
conditions météorologiques dans un élément <Text>
, utilisez une expression semblable à
les éléments suivants:
<Text>
<Font family="SYNC_TO_DEVICE" size="32">
<Template>Today's weather: %s
<Parameter expression="[WEATHER.CONDITION_NAME]"/>
</Template>
</Font>
</Text>
Disponibilité
Les cadrans doivent toujours vérifier la valeur [WEATHER.IS_AVAILABLE]
avant
accédant aux autres membres de l'objet [WEATHER.*]
:
<Condition>
<Expressions>
<Expression name="is_weather_available">[WEATHER.IS_AVAILABLE]</Expression>
</Expressions>
<Compare expression="is_weather_available">
<!-- Weather is available, so show the weather data. -->
</Compare>
<Default>
<!-- Weather isn't available, so show an appropriate message. -->
</Default>
</Condition>
De plus, le cadran doit vérifier [WEATHER.IS_ERROR]
, ce qui indique
une erreur lors du chargement
des données météorologiques.
Notez que les valeurs [WEATHER.IS_AVAILABLE]
et [WEATHER.IS_ERROR]
peuvent toutes les deux être "true",
où les données sont obsolètes et que
les tentatives d'actualisation des données ont échoué. Dans ce cas,
les conditions météo disponibles s'affichent, avec un indicateur
a généré une erreur lors de la récupération des nouvelles données.
Fraîcheur des données
Le code temporel des données disponibles peut être consulté
[WEATHER.LAST_UPDATED]
, qui est un code temporel d'epoch Unix en millisecondes.
Cette valeur peut être formatée à l'aide de la méthode icuText(,)
pour obtenir une
dans un format lisible, comme l'illustre l'échantillon météorologique.
Conditions météo
Les conditions actuelles sont disponibles dans la zone suivante : [WEATHER.CONDITION]
, avec un
une version lisible par l'humain dans [WEATHER.CONDITION_NAME]
.
Les valeurs de [WEATHER.CONDITION]
sont visibles dans les sources de données. Pour
exemple, 4
représente HEAVY_RAIN
.
Autres métriques
Le format de cadran fournit une plage de métriques supplémentaires, comme
[WEATHER.TEMPERATURE]
et [WEATHER.UV_INDEX]
. Pour en savoir plus
des statistiques disponibles, y compris les unités et les types de données, consultez le
sources de données.
Prévisions horaires et quotidiennes
Vous pouvez accéder aux conditions de prévision pour une heure ou un jour spécifique à venir comme suit:
[WEATHER.HOURS.1.CONDITION]
: conditions de prévision dans 1 heure.[WEATHER.DAYS.2.CONDITION]
: conditions de prévision dans deux jours.
Les données disponibles toutes les heures peuvent être disponibles jusqu'à huit heures à l'avance, et les données quotidiennes jusqu'à cinq jours à l'avance.
à l'avance. Toutefois, le cadran doit toujours vérifier la disponibilité des
des données de prévision. Une plage horaire différente peut être disponible à l'adresse
différents moments ou
différents appareils. Par exemple, pour vérifier si les prévisions
les données seront disponibles dans 1 heure. Utilisez [WEATHER.HOURS.1.IS_AVAILABLE]
.
Les prévisions quotidiennes et horaires incluent également toute une série de métriques, telles que :
[WEATHER.HOURS.<N>.TEMPERATURE]
et
[WEATHER.DAYS.<N>.CHANCE_OF_PRECIPITATION]
Pour en savoir plus
des statistiques disponibles, y compris les unités et les types de données, consultez le
sources de données.
Effectuer des tests avec des données météorologiques
Pour obtenir des données météorologiques, l'appareil Wear OS doit connaître leur position.
Pour économiser l'énergie, la montre n'utilise pas le capteur GPS intégré pour déterminer un emplacement pour les prévisions météorologiques et s'appuie plutôt sur la localisation depuis un appareil portable connecté ou à partir des réseaux disponibles.
Pour pouvoir tester les données de localisation, effectuez l'une des opérations suivantes:
- Associez votre émulateur Wear OS à un téléphone physique ou à un émulateur.
- Simulez la localisation à l'aide de la commande adb suivante:
adb unroot
adb shell cmd location set-location-enabled true
adb root
adb shell appops set 0 android:mock_location allow
adb shell cmd location providers add-test-provider gps
adb shell cmd location providers set-test-provider-enabled gps true
adb shell cmd location providers set-test-provider-location gps --location 37.773972,-122.431297
Informations supplémentaires
Pour obtenir un exemple complet d'accès et d'affichage des données météorologiques, consultez la Exemple GitHub.
Recommandations personnalisées
- Remarque : Le texte du lien s'affiche lorsque JavaScript est désactivé
- Modifier le comportement de mise au point
- Effets secondaires dans Compose
- Guide de référence rapide AGSL