Textstringvarianten hinzufügen

Auf unterschiedlich großen Bildschirmen 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 CarTextverwenden.

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

Kotlin

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

Java

CarText itemTitle = new CarText.Builder("This is a very long string")
 .addVariant("Shorter string")
 ...
 .build();

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

Kotlin

GridItem.Builder()
    .addTitle(itemTitle)
    ...
    .build()

Java

new GridItem.Builder()
    .addTitle(itemTitle)
    ...
    build();

Fügen Sie Strings in der Reihenfolge von der am meisten zur am wenigsten bevorzugten Variante hinzu. Beispielsweise vom längsten zum kürzesten String. Der Host wählt den String mit der passenden Länge aus, je nachdem, wie viel Platz auf dem Bildschirm im Auto verfügbar ist.