Ajouter des variantes de chaîne de texte

La quantité de texte affichée peut varier en fonction de la taille de l'écran de la voiture. Avec le niveau d'API Car App 2 et les niveaux ultérieurs, vous pouvez spécifier plusieurs variantes d'une chaîne de texte pour l'adapter au mieux à l'écran. Pour savoir où les variantes de texte sont acceptées, recherchez les modèles et les composants qui acceptent CarText.

Vous pouvez ajouter des variantes de chaîne de texte à un CarText avec la méthode CarText.Builder.addVariant() :

val itemTitle = CarText.Builder("This is a very long string")
    .addVariant("Shorter string")
    .build()
TextStringVariants.kt

Vous pouvez ensuite utiliser ce CarText, par exemple comme texte principal d'un GridItem.

val gridItem = GridItem.Builder()
    .setTitle(itemTitle)
    .setImage(CarIcon.APP_ICON)
    .build()
TextStringVariants.kt

Ajoutez les chaînes dans l'ordre de préférence (de la plus à la moins préférée). Par exemple, du plus long au plus court. L'hôte choisit la chaîne de longueur appropriée en fonction de l'espace disponible sur l'écran de la voiture.