データバインディングコンテキストのViewportオブジェクト

Note: Sign in to the developer console to build or publish your skill.

Alexa Presentation Language（APL）ドキュメントのデータバインディングコンテキストには、表示デバイスの動作特性を示すviewportプロパティが含まれています。

注： viewportプロパティは、APLドキュメントでデータバインディングコンテキストの一部として使用できます。これはスキルに送信されたリクエストに含まれるViewport情報とは別のもので、こちらの情報にはスキルコードからアクセスできます。

Viewportオブジェクトの例

たとえば、初代のEcho ShowのViewportオブジェクトでは次のプロパティが報告されます。

{
  "viewport": {
    "width": 1024,
    "height": 600,
    "pixelWidth": 1024,
    "pixelHeight": 600,
    "shape": "rectangle",
    "dpi": 160,
    "theme": "dark",
    "mode": "hub",
    "autoHeight": false,
    "autoWidth": false,
    "minHeight": 600,
    "minWidth": 1024,
    "maxHeight": 600,
    "maxWidth": 1024
  }
}

ドキュメントで条件付きロジックを使用することで、Viewportに応じて異なるエクスペリエンスを提供できます。

プロパティ

viewportオブジェクトには、次の表に示すプロパティがあります。

プロパティ	型	説明
`autoHeight`	ブール値	`true`の場合、Viewportは高さの自動調整をサポートします。
`autoWidth`	ブール値	`true`の場合、Viewportは幅の自動調整をサポートします。
`dpi`	整数	Viewportのピクセル密度です。
`height`	正のディメンション	デフォルトの高さをディスプレイ非依存ピクセル（dp）単位で示します。
`maxHeight`	正のディメンション	最大の高さをディスプレイ非依存ピクセル（dp）単位で示します。
`maxWidth`	正のディメンション	最大の幅をディスプレイ非依存ピクセル（dp）単位で示します。
`minHeight`	正のディメンション	最小の高さをディスプレイ非依存ピクセル（dp）単位で示します。
`minWidth`	正のディメンション	最小の幅をディスプレイ非依存ピクセル（dp）単位で示します。
`mode`	モード	動作モードです。
`pixelHeight`	整数	デフォルトの高さをピクセル単位で示します。
`pixelWidth`	整数	デフォルトの幅をピクセル単位で示します。
`shape`	有効な値：`round`または`rectangle`	Viewportの形状です。
`theme`	文字列	選択されている色スキーマです。
`width`	正のディメンション	デフォルトの幅をdp単位で示します。

autoHeight

trueの場合、APLドキュメントの高さはminHeightからmaxHeightまでの範囲で調整される可能性があります。falseの場合、Viewportは常に正確にheightの高さになります。

autoHeightプロパティは、Viewportの高さが可変かどうかをすばやく確認できる便利なプロパティです。このプロパティは${viewport.height != viewport.maxHeight || viewport.height != viewport.minHeight}と同じです。

autoWidth

trueの場合、APLドキュメントの幅はminWidthからmaxWidthまでの範囲で調整される可能性があります。falseの場合、Viewportは常に正確にwidthの幅になります。

autoWidthプロパティは、Viewportの幅が可変かどうかをすばやく確認できる便利なプロパティです。このプロパティは${viewport.width != viewport.maxWidth || viewport.width != viewport.minWidth}と同じです。

dpi

ディスプレイ非依存ピクセル（dp）は、携帯電話を見るときの距離で画面を持ち、画面のピクセル密度が1インチ（3cm）あたり約160ピクセルであると仮定した場合の画面のビジュアルサイズを表す測定単位です（初代iPhoneの画面では1インチあたり163ピクセルでした）。物理的な大きさが同じ2つの画面を同じ距離から見た場合、画面の実際のピクセル密度にかかわらず、2つの画面のdpディメンションはほぼ同じになります。

Viewportのdpi（インチあたりのドット数）とは、人が見たとおりのポイントまたはピクセルのサイズを表した値であり、画面の実際のインチあたりのピクセル数とは異なります。dpiを求める公式は次のとおりです。

dpi = 160 *（ピクセルサイズ / dpサイズ）

サポートされているDPIの値は、 120、160、213、240、320、480、640です。

実際には、画面のdpiサイズは物理的な寸法と想定される視聴距離に基づいてメーカーによって選択され、そのdpiを基にdpサイズが計算されます。たとえば、1080pのテレビでメーカーが推奨する視聴距離は、実際の画面サイズにかかわらず、テレビ画面の対角線の長さの約2倍です。視聴者に対するテレビの見た目の大きさは一定のため、すべての1080pのテレビはdpiが320、pixelHeightが1080、heightが540になります。

height

Viewportのheightプロパティは、Viewportの推奨される高さ（ディスプレイ非依存ピクセル単位）です。autoHeightがfalseの場合、この高さが厳密に適用されます。画面上でViewportが占める高さは、指定されたとおりの値になります。autoHeightがtrueの場合、この高さは推奨されるデフォルト値ですが、実際の高さはminHeightからmaxHeightまでの範囲で変わる可能性があります。Viewport内に表示されるAPLドキュメントは、Viewportの境界で切り抜かれます。