テキスト文字列のバリエーションを追加する

自動車の画面サイズに応じて、表示されるテキストの量は異なります。自動車向けアプリの API レベル 2 以上では、画面に合う最適なテキスト文字列のバリエーションを複数指定できます。テキストのバリエーションを使用できる場所を確認するには、CarText を使用するテンプレートとコンポーネントを探してください。

テキスト文字列のバリエーションを CarText に追加するには、CarText.Builder.addVariant() メソッドを使用します。

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

たとえば、この CarText を GridItem のメインテキストとして使用できます。

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

文字列は優先度の高い順に追加します。たとえば、長い順から短い順に並べます。ホストは車の画面上のスペースに応じて、適切な長さの文字列を選択します。