データバインディングコンテキストのビューポート情報(キャラクターディスプレイ)
データバインディングコンテキストのビューポート情報(キャラクターディスプレイ)
データバインディングコンテキストには、ディスプレイデバイスの動作特性を示すviewportプロパティが含まれています。
注:
viewportプロパティは、APLドキュメントでデータバインディングコンテキストの一部として使用できます。これはスキルに送信されたリクエストに含まれるビューポート情報とは別のもので、こちらの情報にはスキルコードからアクセスできます。viewportプロパティの例
Echo Dot with clockなどの文字ベースのデバイスに対応するviewportのプロパティは、たとえば次のようになります。
"viewport": {
"width": 4,
"height": 1,
"format": "SEVEN_SEGMENT"
}
viewportのプロパティ
viewportには、以下の定義済みプロパティがあります。
| プロパティ | 型 | 説明 |
|---|---|---|
| format | 文字列 | 表示可能な文字の種類です。 |
| width | 数値 | ビューポートの幅(文字単位)です。 |
| height | 数値 | ビューポートの高さ(文字単位)です。 |
format
formatプロパティには、デバイスが表示できるサポート対象文字を特定する値が設定されます。
サポート対象外の文字が出現すると、空白文字「 」として表示されます。
formatプロパティが返す値は次のとおりです。
SEVEN_SEGMENT
SEVEN_SEGMENT
デバイスは、7セグメントディスプレイでレンダリング可能な数字と一部の文字を表示できます。
- サポートされる数字
- 0、1、2、3、4、5、6、7、8、9
- サポートされる文字
- A、b、C、c、d、E、F、G、H、h、I、J、L、n、O、o、P、q、r、S、t、U、u、y、_(アンダースコア)、空白文字(「 」)
下の図は、サポートされる文字の7セグメント形式の表示です。

- サポートされない文字
- a、B、D、e、f、g、i、j、K、k、l、M、m、N、p、Q、R、s、T、V、v、W、w、X、x、Y、Z、z
サポートされない文字は空白文字(「 」)として扱われます。
- 大文字の「B」には、同じ形となる数字の8を使用できます。
- 小文字の「g」には、同じ形となる数字の9を使用できます。
- 小文字の「l」(エル)には、同じ形となる大文字のI(アイ)を使用できます。
widthとheight
widthプロパティとheightプロパティには、画面の現在のサイズが文字単位で設定されます。viewportのディメンションでは、セグメント間文字はカウントされません。
たとえば、Echo Dot with clock用のviewportは、widthが4、heightが1になります。
このページは役に立ちましたか?
最終更新日: 2025 年 12 月 23 日