開発者コンソール

Alexa.KeypadControllerインターフェース


Alexa.KeypadControllerインターフェース

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

SendKeystrokeディレクティブの発話

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

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

ユーザーが以下の発話を行うと、AlexaはLambdaにSendKeystrokeディレクティブを送信します。

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

Go up

go down

go left

go right

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

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

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

vai su

Vai giù / scendi

voglio andare verso sinistra

voglio andare verso destra

ve te arriba

ve te abajo

ve te a la izquierda

ve a la izquierda

ve te a la derecha

ve a la derecha

上に行って

下に行って

左側に行って

右の方へ行って

Subir/suba/sobe

Vá/vai/ir para baixo

Vá/vai/ir para esquerda

Vá/vai/ir para direita

ऊपर जाओ

ऊपर करो

नीचे जाओ *

नीचे जाना *

*ambiguity with "move down"

left जाना *

बाएं जाओ *

left पे जाओ *

*ambiguity with "move left"

right जाना

right पे जाओ

दायें जाओ

*ambiguity with "move right"

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

3.0

方向ナビゲーション - 移動

Move up

move down

move left

move right

nach oben bewegen

nach unten bewegen

nach links bewegen

nach rechts bewegen

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

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

salta su

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

voglio andare verso sinistra

voglio andare verso destra

muéve te hacia arriba

muéve te hacia abajo

muéve te hacia izquierda

muéve te hacia derecha

上に移動して

下の方へ移動して

左の方へ移動して

右側に移動して

Mover/mova/move pra cima

Mova/move/mover para baixo

Mova/move/mover para a esquerda

Mova/move/mover para direita

ऊपर जाओ

ऊपर करो

नीचे जाओ *

नीचे जाना *

*ambiguity with "move down"

left जाना *

बाएं जाओ *

left पे जाओ *

*ambiguity with "move left"

right जाना

right पे जाओ

दायें जाओ

*ambiguity with "move right"

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

3.0

方向スクロール

Scroll up

scroll down

scroll left

scroll right

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

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

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

scorri verso l'alto

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

scorri verso sinistra

scorri verso destra

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

上にスクロールして

下にスクロールして

左の方にスクロールして

右側へスクロールして

Rolar/rola/role para cima

Rola/role/rolar para baixo

Rola/role/rolar para a esquerda

Rola/role/rolar para a direita

उपर चलो

ऊपर scroll

ऊपर करो

नीचे scroll करें

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

scroll down करो

left scroll करो

left की तरफ scroll करो

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

right scroll करो

right की तरफ scroll करो

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

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

3.0

ページ内で移動

Page up

page down

page left

page right

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

page vers le haut

Page vers le bas

Page vers la gauche

Page vers la droite

page vers le haut

Page vers le bas

Page vers la gauche

Page vers la droite

pagina in su

pagina di sotto

pagina sinistra/pagina di sinistra

pagina destra/pagina di destra

arriba de la página

abajo de la página

izquierda de la página

derecha de la página

画面の上部へ

ページの下へ

画面の左へ

ページの右の方へ

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

Página para baixo

Pagina para esquerda

Página para direita

पेज ऊपर करो

पेज नीचे करो

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

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

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

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

page नीचे करो

page down करो

page को बाएँ कर दो

page left  करो

page को दाएँ  करो

page right करो

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

3.0

動詞のない方向ナビゲーション

Up

Down

Left

Right

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

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

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

su

giù

verso sinistra

verso destra

ve te arriba

ve te abajo

izquierda

ve te a la derecha

ve a la derecha

*

 

*

*

Ir/vai/vá pra cima

Ir/vai/vá pra baixo

Ir/vai/vá pra esquerda

Ir/vai/vá pra direita

ऊपर

ऊपर जाओ

उपर चलो

ऊपर करो

नीचे

नीचे जाओ

नीचे चलो

नीचे करो

left

बाएँ जाओ

बाएँ

बाएँ करो

Right

दाएँ जाओ

दाएँ

दाएँ करो

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

3.0

これ(それ)を選択する/選ぶ

Select this

nimm das

wähl das aus?

klick die an

diese

sélectionne ça

choisis ça

sélectionne ça

choisis ça

seleziona questo

scegli questo

selecciona esto

selecciona este

selecciona aquel

これ選んで

escolher isso/esse/essa

selecionar isso/essa/ esse

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

इसे चुनो

इसको select करो

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

3.0

もっと表示する/見る

Show more

mehr ansehen/sehen

zeig mir mehr

zeig mir mehr davon

zeig mir mehr auf <AppName> zeig mir mehr filme an?

montre moi en plus

montre en plus

encore

montre moi en plus

montre en plus

encore

mostra mi di più

muestra más

muestra qué más hay

quiero ver algo más

veamos un poco más

veamos algo más

もっと見せて

Mostrar/mostra/mostre mais

और दिखाओ

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

3.0

詳細(情報)を表示する/見る

Show details

details ansehen/sehen

zeig details an

liefere/gib mir mehr details

mehr details

montre des détails

montre moi des détails

voir plus d'infos

montre des détails

montre moi des détails

voir plus d'infos

fornisci dettagli mostra più dettagli mostra i dettagli

muestra detalles

enseña detalles

ver detalles

詳細を表示して

ver todos os detalhes do progama/show

details दिखाओ

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

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

3.0

SendKeystrokeディレクティブの例

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

{
  "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イベントで応答します。応答は、同期または非同期のどちらでも実行できます。非同期で応答する場合は、相関トークン、および認可トークンを含むスコープを追加してください。

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

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

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

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

エラーレスポンス

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