Textstringvarianten hinzufügen

Auf unterschiedlich großen Displays im Auto wird möglicherweise eine unterschiedliche Menge an Text angezeigt. Mit der Car App API-Ebene 2 und höher können Sie mehrere Varianten eines Textstrings angeben, damit er optimal auf den Bildschirm passt. Wenn Sie sehen möchten, wo Textvarianten akzeptiert werden, suchen Sie nach Vorlagen und Komponenten, die ein CarText verwenden.

Sie können einem CarText mit der CarText.Builder.addVariant() Methode Textstringvarianten hinzufügen:

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

Anschließend können Sie dieses CarText beispielsweise als primären Text eines GridItem verwenden.

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

Fügen Sie Strings in der Reihenfolge von der am meisten zur am wenigsten bevorzugten Variante hinzu. Zum Beispiel vom längsten zum kürzesten String. Der Host wählt den String mit der passenden Länge je nach verfügbarem Platz auf dem Display im Auto aus.