オンスクリーンナビゲーションの使用 - Amazon Vega Docs

Amazon Developer

Console

as

Settings

Sign out

Notifications

Alexa

Amazonアプリストア

Ring

AWS

ドキュメント

Support

Contact Us

My Cases

Console

as

Vega開発者向けドキュメント

開発

設計と開発

公開

リファレンス

サポート

Vegaは、UIController APIを通じて音声によるオンスクリーンナビゲーションを提供します。APIにアクセスするには、Button、Pressable、Text、TouchableHighlight、TouchableOpacity、TouchableWithoutFeedback、Viewの各コンポーネントに、ariaPosInSet、aria-label、keplerAltLabels、alexaEntityType、alexaExternalIDの各プロパティを設定します。 ariaPosInSetプロパティとaria-labelプロパティは、Accessible Rich Internet Applications（ARIA）機能を実装します。

ariaPosInSet -「position in set」の略。現在のリストアイテムまたはツリーアイテムのセット内での要素の番号または位置を定義します。
aria-label - 対話型コンポーネントを音声で選択するための名前を指定する文字列です。

現在ariaLabelを使用して音声選択用の名前を指定しているアプリには、下位互換性が提供されます。ただし、アプリをaria-labelに移行することが推奨されます。 aria-labelに加えて、Vegaはコンポーネントの代替ラベルもサポートします。

keplerAltLabels - コンポーネントを音声で選択するための追加の名前のリストです。

次のプロパティは、Alexa固有のプロパティを定義します。

alexaEntityType - Alexaのエンティティタイプを指定します。詳細については、Alexa.UIControllerインターフェース（VSK Fire TV）のEnum<EntityTypes>を参照してください。

アプリでオンスクリーンナビゲーションを有効にするには、manifest.tomlでkva-categoryを宣言する必要があります。 componentsセクションに次の宣言を追加します。

categories = ["com.amazon.category.kva"]

manifest.tomlファイルの詳細については、Vegaアプリのマニフェストファイルを参照してください。 UIController APIなどの音声機能を使用するアプリをサイドロードする場合、それらの機能を有効にするには、デバイスを再起動する必要があります。次のコード例は、オンスクリーンナビゲーションに対応するボタンのようなコンポーネントをレンダリングする方法を示しています。

<TouchableOpacity
    testID={"touchable opacity testid"}
    aria-label={'ザ・マーベラス・アイアンマン'}
    ariaPosInSet={1}
    alexaEntityType={'VideoObject'}
    keplerAltLabels={["アイアンマン", "マーベラス・アイアンマン"]}
>
    <View>
        <Text
            testID='vn_touchable_opacity_text'
            style={styles.buttonText}>
                {"1. " + "ザ・マーベラス・アイアンマン"}
        </Text>
    </View>
</TouchableOpacity>

関連トピック

フォーカス管理

最終更新日 2026年10月26日