開発者コンソール

Alexa.KeypadControllerインターフェース


Alexa.KeypadControllerインターフェース

ユーザーが画面上の要素を選択またはスクロールするリクエストを行うと、keystroke値(UPDOWNなど)を含んだSendKeystrokeディレクティブをAlexa.KeypadControllerインターフェースがアプリまたはLambdaに送信します。

KeypadControllerと組み込みの音声ナビゲーション・選択機能

Fire TVには既に、アプリ内の音声ナビゲーション・選択の機能が組み込まれており、(VSKが統合されているかどうかに関係なく)Fire TV上のほとんどのアプリで無償で利用できます。この組み込みの機能により、Fire TVは、ユーザーがスクロールコマンド(「アレクサ、右にスクロールして」、「アレクサ、これを選択して」など)を発したときにスクロールする距離を推測します。

「アプリ内音声ナビゲーション・選択」機能は、D-Padナビゲーションイベントを音声コマンドにマッピングすることで動作します。D-Padとは、上下左右にスクロールする際に使用する、リモコンの方向キーパッド([選択] ボタンの周囲にある「ナビゲーション」リング)のことです。Alexaにより、音声コマンドがD-Padナビゲーションイベントに変換され、そのイベントがアプリに送信されます。

KeypadControllerには同様の機能があり、開発者がスクロールと選択を制御することができます。アプリでKeypadController機能を宣言すると、組み込みの音声ナビゲーション・選択機能が非アクティブになり、KeypadControllerが優先されます。アプリまたはLambdaでスクロールおよび選択のディレクティブを直接受け取り、リクエストに対応することができます。ただし通常は、Fire TVにあらかじめ組み込まれている機能を使用せず、KeypadControllerを実装しなければならない理由はありません。

SendKeystrokeディレクティブの発話

ユーザーは、以下に関する発話を行うことができます。

  • D-Padで指定された方向への移動
  • フォーカスされている要素の選択
  • リスト、メニュー項目、タイトル、説明といった要素のスクロール
  • 現在画面外にある情報の表示

ユーザーが以下の発話を行うと、AlexaはSendKeystrokeディレクティブをアプリ(アプリのみの統合の場合)またはLambda(クラウド側の統合の場合)に送信します。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

Go up

go down

go left

go right

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

Move up

move down

move left

move right

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

Scroll up

scroll down

scroll left

scroll right

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

Page up

page down

page left

page right

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

Up

Down

Left

Right

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

Select this

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

Show more

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

Show details

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

va vers le haut

monte vers le haut

remonte

va en bas

descends

faire défiler vers le bas

va à gauche

aller à gauche

va à droite

aller à droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

va vers le haut

monte vers le haut

remonte

navigue en bas

navigue vers le bas

Naviguer à gauche

Naviguer vers la gauche

Naviguer à droite

Naviguer vers la droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

fais défiler vers le haut

fais défiler en haut

faire défiler vers le bas

défiler vers le bas

se déplacer vers le bas

fais défiler à gauche

faire défiler à gauche

défiler à gauche

se déplacer à droite

fais défiler à droite

faire défiler à droite

défiler à droite

se déplacer à droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

page vers le haut

Page vers le bas

Page vers la gauche

Page vers la droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

va en haut

monte

faire défiler vers le haut

va en bas

descends

faire défiler vers le bas

fais défiler à gauche

va à gauche

faire défiler à gauche

se déplacer à gauche

aller à gauche

défiler à gauche

fais défiler à droite

va vers la droite

fais défiler vers la droite

déplace-toi vers la droite

aller à droite

défile à droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

sélectionne ça

choisis ça

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

montre moi en plus

montre en plus

encore

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

montre des détails

montre moi des détails

voir plus d'infos

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

va vers le haut

monte vers le haut

remonte

va en bas

descends

faire défiler vers le bas

va à gauche

aller à gauche

va à droite

aller à droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

va vers le haut

monte vers le haut

remonte

navigue en bas

navigue vers le bas

Naviguer à gauche

Naviguer vers la gauche

Naviguer à droite

Naviguer vers la droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

fais défiler vers le haut

fais défiler en haut

faire défiler vers le bas

défiler vers le bas

se déplacer vers le bas

fais défiler à gauche

faire défiler à gauche

défiler à gauche

se déplacer à droite

fais défiler à droite

faire défiler à droite

défiler à droite

se déplacer à droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

page vers le haut

Page vers le bas

Page vers la gauche

Page vers la droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

va en haut

monte

faire défiler vers le haut

va en bas

descends

faire défiler vers le bas

fais défiler à gauche

va à gauche

faire défiler à gauche

se déplacer à gauche

aller à gauche

défiler à gauche

fais défiler à droite

va vers la droite

fais défiler vers la droite

déplace-toi vers la droite

aller à droite

défile à droite

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

sélectionne ça

choisis ça

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

montre moi en plus

montre en plus

encore

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

montre des détails

montre moi des détails

voir plus d'infos

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

geh/e nach oben

nach oben/rauf/hinauf/hoch gehen

gehe hoch

geh rauf/hinauf

nach unten/runter/hinunter gehen

geh runter/nach unten/hinunter

geh nach links

geh nach rechts

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

nach oben bewegen

nach unten bewegen

nach links bewegen

nach rechts bewegen

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

scroll hoch

scroll nach oben

scroll rauf

scrolle hinauf

scrolle hoch

scroll hier/dahin/dorthin runter

scroll zum letzten runter

scroll runter/hinunter/nach unten

runter/hinunter/nach unten scrollen

scroll nach links

scroll links

scroll nach rechts

scroll rechts

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

seite nach oben

seite rauf

seite hinauf

seite hoch

blätter hoch

blätter runter

seite runter/hinunter/nach unten

blätter links

seite nach links

seite links

blätter rechts

seite nach rechts

seite rechts

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

nach oben bewegen

bätter hoch

geh hoch

scroll hoch

scroll nach oben

nach unten bewegen

blätter runter

scroll hier/dahin/dorthin runter geh runter/nach unten

scroll hinunter/nach unten runter/hinunter gehen

seite runter/hinunter/nach unten

nach links bewegen

blätter links

seite nach? links

scroll nach? links

geh nach links

nach rechts bewegen

blätter rechts

seite nach? rechts

scroll nach? rechts

geh nach rechts

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

nimm das

wähl das aus?

klick die an

diese

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

mehr ansehen/sehen

zeig mir mehr

zeig mir mehr davon

zeig mir mehr auf [AppName] zeig mir mehr filme an?

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

details ansehen/sehen

zeig details an

liefere/gib mir mehr details

mehr details

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

ऊपर जाओ

ऊपर करो

नीचे जाओ *

नीचे जाना *

*ambiguity with "move down"

left जाना *

बाएं जाओ *

left पे जाओ *

*ambiguity with "move left"

right जाना

right पे जाओ

दायें जाओ

*ambiguity with "move right"

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

ऊपर जाओ

ऊपर करो

नीचे जाओ *

नीचे जाना *

*ambiguity with "move down"

left जाना *

बाएं जाओ *

left पे जाओ *

*ambiguity with "move left"

right जाना

right पे जाओ

दायें जाओ

*ambiguity with "move right"

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

उपर चलो

ऊपर scroll

ऊपर करो

नीचे scroll करें

नीचे की तरफ scroll करो

scroll down करो

left scroll करो

left की तरफ scroll करो

बायें की तरफ scroll करो

right scroll करो

right की तरफ scroll करो

दाएँ की तरफ scroll करो

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

पेज ऊपर करो

पेज नीचे करो

पेज को left पे ले जाओ

पेज को right पे ले जाओ

पेज को बाएँ ले जाओ

पेज को दाएँ ले जाओ

page नीचे करो

page down करो

page को बाएँ कर दो

page left  करो

page को दाएँ  करो

page right करो

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

ऊपर

ऊपर जाओ

उपर चलो

ऊपर करो

नीचे

नीचे जाओ

नीचे चलो

नीचे करो

left

बाएँ जाओ

बाएँ

बाएँ करो

Right

दाएँ जाओ

दाएँ

दाएँ करो

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

इसे चुनो

इसको select करो

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

और दिखाओ

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

details दिखाओ

जानकारी दिखाओ

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

vai su

Vai giù / scendi

voglio andare verso sinistra

voglio andare verso destra

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

salta su

Passa giù /passa in giù/salta giù / scendi/ salta verso il basso

voglio andare verso sinistra

voglio andare verso destra

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

scorri verso l'alto

scorri giù / scorri verso il basso /scrolla giù

scorri verso sinistra

scorri verso destra

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

pagina in su

pagina di sotto

pagina sinistra/pagina di sinistra

pagina destra/pagina di destra

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

su

giù

verso sinistra

verso destra

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

seleziona questo

scegli questo

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

mostra mi di più

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

fornisci dettagli mostra più dettagli mostra i dettagli

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

上に行って

下に行って

左側に行って

右の方へ行って

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

上に移動して

下の方へ移動して

左の方へ移動して

右側に移動して

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

上にスクロールして

下にスクロールして

左の方にスクロールして

右側へスクロールして

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

画面の上部へ

ページの下へ

画面の左へ

ページの右の方へ

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

*

 

*

*

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

これ選んで

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

もっと見せて

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

詳細を表示して

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

Subir/suba/sobe

Vá/vai/ir para baixo

Vá/vai/ir para esquerda

Vá/vai/ir para direita

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

Mover/mova/move pra cima

Mova/move/mover para baixo

Mova/move/mover para a esquerda

Mova/move/mover para direita

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

Rolar/rola/role para cima

Rola/role/rolar para baixo

Rola/role/rolar para a esquerda

Rola/role/rolar para a direita

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

página para cima/ ir para cima na página

Página para baixo

Pagina para esquerda

Página para direita

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

Ir/vai/vá pra cima

Ir/vai/vá pra baixo

Ir/vai/vá pra esquerda

Ir/vai/vá pra direita

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

escolher isso/esse/essa

selecionar isso/essa/ esse

esse aqui / esse/ essa aqui/ essa/ isso aqui/ isso

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

Mostrar/mostra/mostre mais

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

ver todos os detalhes do progama/show

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

機能 サンプル発話 想定されるレスポンス
方向ナビゲーション - 行く
認定に必須

ve te arriba

ve te abajo

ve te a la izquierda

ve a la izquierda

ve te a la derecha

ve a la derecha

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向ナビゲーション - 移動
認定に必須

muéve te hacia arriba

muéve te hacia abajo

muéve te hacia izquierda

muéve te hacia derecha

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右へ移動します。

方向スクロール
認定に必須

despláza te hacia arriba

despláza te para arriba

despláza te hacia abajo

despláza te para abajo

despláza te hacia izquierda

despláza te para izquierda

despláza te hacia derecha

despláza te para derecha

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右にスクロールします。

ページ内で移動
認定に必須

arriba de la página

abajo de la página

izquierda de la página

derecha de la página

D-Padコントローラーで上下左右を押した場合と同様に、アプリ内のページを上下左右に移動します。

動詞のない方向ナビゲーション
認定に必須

ve te arriba

ve te abajo

izquierda

ve te a la derecha

ve a la derecha

D-Padコントローラーで上下左右を押した場合と同様に、アプリが上下左右に移動します。

これ(それ)を選択する/選ぶ
認定に必須

selecciona esto

selecciona este

selecciona aquel

フォーカスが置かれている対象が選択されます。

もっと表示する/見る
省略可能

muestra más

muestra qué más hay

quiero ver algo más

veamos un poco más

veamos algo más

さらに多くのアイテムが表示されます。たとえば、リストに表示されるアイテム数が限られている場合は、さらに多くのアイテムが取得されて表示されます。

詳細(情報)を表示する/見る
省略可能

muestra detalles

enseña detalles

ver detalles

さらに詳細な情報が表示されます。たとえば、情報が切り詰められている場合は、詳細情報が表示されます。

SendKeystrokeディレクティブの例

KeypadControllerインターフェースから送信されるKeyStrokeディレクティブの例を以下に示します。

EXTRA_DIRECTIVE_NAMESPACE: Alexa.KeypadController
EXTRA_DIRECTIVE_NAME: KeyStroke
EXTRA_DIRECTIVE_PAYLOAD_VERSION: 3
EXTRA_DIRECTIVE_PAYLOAD: payload

payloadの内容は以下のとおりです。

{
    "payload": {
      "keystroke": "SELECT"
    }
}
{
  "directive": {
    "header": {
      "namespace": "Alexa.KeypadController",
      "name": "SendKeystroke",
      "messageId": "<メッセージID>",
      "correlationToken": "<opaque相関トークン>",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "<OAuth2ベアラートークン>"
      },
      "endpointId": "<エンドポイントID>",
      "cookie": {}
    },
    "payload": {
      "keystroke": "SELECT"
    }
  }
}

ペイロードの説明

SendKeystrokeディレクティブでは、payloadkeystrokeプロパティを使用して、実行するアクションを指定します。

フィールド 説明
keystroke ユーザーが要求したキーストロークです。 文字列

keystrokeに指定できる値は、 UPDOWNLEFTRIGHTSELECTPAGE_UPPAGE_DOWNPAGE_LEFTPAGE_RIGHTINFOMOREです。以下の表を参照してください。

キーストロークの種類 キーストローク値 説明
方向パッド(D-Pad) UPDOWNLEFTRIGHTSELECT 1単位分または次の画面要素まで上下左右に移動するか、フォーカスされている要素またはアイテムを選択します。
スクロール PAGE_UPPAGE_DOWNPAGE_LEFTPAGE_RIGHT 指定された方向にスクロールします。
情報 INFOMORE 現在フォーカスされている画面要素の詳しい情報を表示します。たとえば、画面外のコンテンツを表示したり、詳細ページにジャンプしたりします。

レスポンスの例

SendKeystrokeディレクティブの処理を正常に終了した場合は、Alexa.Responseイベントで応答します。応答は、同期または非同期のどちらでも実行できます。非同期で応答する場合は、相関トークン、および認可トークンを含むスコープを追加してください。

最初のタブ
2番目のタブ

SendKeystrokeレスポンスイベントの例

{
  "event": {
    "header": {
      "namespace": "Alexa",
      "name": "Response",
      "messageId": "<メッセージID>",
      "correlationToken": "<opaque相関トークン>",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "<OAuth2ベアラートークン>"
      },
      "endpointId": "<エンドポイントID>"
    },
    "payload": {}
  }
}

何らかの理由でユーザーのリクエストを完了できない場合は、エラーレスポンスを返す必要があります。詳細については、エラー処理を参照してください。

インターフェース機能に対するサポートの宣言

アプリでKeypadControllerを受け取るには、機能を宣言する際にこのインターフェースのサポートを明示する必要があります。アプリのみの統合での機能の宣言の詳細については、以下を参照してください。

ビデオスキルがAlexa.KeypadControllerインターフェースをサポートしていることを示すには、Alexa.Discoveryインターフェースを介して送信されたDiscoverディレクティブへのレスポンスで、そのサポートを明示する必要があります。(KeypadControllerインターフェースの機能の宣言を参照)。必ず、keys属性を追加し、サポートしているキーストロークのリストを指定してください。また、KeypadControllerを使用するにはAlexa Client Libraryバージョン1.4.5以降が必要です。詳細については、Discoveryインターフェースを参照してください。