Alexa Presentation Languageの既知の問題
Alexa Presentation Language（APL）の既知の問題、バグ、重大な変更点については、以下の一覧を参照してください。
既知の問題
-
［ツール］AlexaIconコンポーネントには、アイコンでカスタムスタイルを使用するために割り当てることができる
iconStyleプロパティが含まれています。Alexaアイコンライブラリのアイコンに使用すると、カスタムスタイルによってアイコンのopacityが変更されることがあります。このスタイルは、ほかのプロパティ（塗りつぶしの色とストローク）には影響しません。 - Echo Show 5（第3世代、2023年リリース）デバイスで、デバイスに2023.2が搭載されていても、
environment.aplVersionプロパティが2023.1として報告されます。- このようなデバイスでも、2023.2でリリースされた機能は動作します。
- ただし、これらのデバイスでは、
${environment.aplVersion == '2023.2'}のような式はfalseを返します。このため、whenを使用してAPLバージョンごとに異なるエクスペリエンスを提供している場合、これらのデバイスは問題が修正されるまで2023.1デバイスとして動作します。
-
［ツール］開発者コンソールのスマートモーションシミュレーターで、APLスマートモーション拡張機能とAPL Entity-Sensing拡張機能が正しく読み込まれません。これらの拡張機能は、サポート対象の物理デバイスでは引き続き動作します。
-
ユーザーが音声でスキルを呼び出すと、ウィジェットの視覚コンテキストが設定されません。
-
マルチモーダル応答ビルダーのユーザーインターフェースに関する問題： 応答をスキルに統合するページに移動した後、開発者コンソールのサイドバーのマルチモーダル応答をクリックしても、マルチモーダル応答ページに移動しません。この問題を回避するには、まずサイドバーのインターフェースをクリックしてから、マルチモーダル応答をクリックします。
-
VectorGraphicの線形グラデーションが、オーサリングツールと物理デバイスで異なって見えます。 -
［タブレット］
AlexaImageList： 縦長の10インチデバイスで、無効に設定されたリストの項目の動作が正しくありません。 -
物理デバイスで、
FrameにImageコンポーネントが含まれていると、FrameのborderRadiusプロパティによるFrameの角の調整が正しく行われません。 -
［Fire TV Edition TV］音量パネルを閉じた後、レシピ動画が元の音量に戻りません。
-
<nobr>タグの前の改行可能な位置で正しく改行が行われません。 -
<nobr>を含むテキストが、コンテナーの最後で不適切に折り返されます。 -
［APLシミュレーター］［大型デバイス／超大型TVデバイス］
autoplayがfalseとtrueのどちらのシナリオでも、ビデオが再生されません。 - APLドキュメントで、
Videoコンポーネントのwidthプロパティとheightプロパティを0に設定してオーディオの再生に使用しようとしても、この方法は機能しません。この問題を回避するには、widthとheightを1に設定します。
重大な変更点
-
［APL 2024.2］APLは、ビデオの再生中にドキュメントをタイムアウトするかどうかを決定するために、
Videoコンポーネントのブール型のscreenLockプロパティを使用するようになりました。このプロパティのデフォルトはtrueです。この場合、ビデオ再生時に自動的に操作タイマーが無効になり、再生中にドキュメントがタイムアウトするのを防ぎます。以前のバージョンのAPLでは、この目的のために一部のデバイスで
audioTrackプロパティが使用され、audioTrackがbackgroundまたはnoneの場合にタイムアウトが許可されていました。ドキュメントのタイムアウトをaudioTrackプロパティに従って決定している場合は、新しいscreenLockプロパティをfalseに設定してください。 -
［APL 2023.2］APLによって生成されたJSONで、必要に応じて数値が整数としてシリアル化されるようになりました。以前のAPLでは、すべての数値が浮動小数点数としてシリアル化されていました。たとえば、値
5を渡すSendEventコマンドは、この値を5.0ではなく5としてシリアル化するようになりました。この変更は、ユーザーイベント、動的データリクエスト、視覚コンテキスト、拡張機能のメッセージなど、APLコアライブラリによってシリアル化されるすべてのJSON構造に影響します。 -
［APL 1.6］Echo Show 8が「デバイス、横長、中」デバイスとして扱われるようになりました。Echo Show 8に関するユーザーのフィードバックから、多くのAlexaエクスペリエンスでフォントサイズが小さかったことがわかりました。これに対処するために、Amazonでは、デバイスによる画面サイズの報告方法を更新して、このデバイスが「デバイス、横長、大」ではなく「デバイス、横長、中」として分類されるようにしました。この変更に対応するには、Alexa開発者コンソールのインターフェースページに移動して、「デバイス、横長、中」のボックスを、サポートするほかのすべてのビューポートのボックスと共にオンにしてください。既存のスキルは影響を受けません。既存のスキルでは、サポートするビューポートプロファイルとして「デバイス、横長、中」のチェックボックスをオンにしてオプトインするまで、Echo Show 8が引き続き「デバイス、横長、大」として認識されます。
-
［APL 1.6］バージョン1.6より前のAPLドキュメントでは、PagerがFireTVの方向キーによってアニメーションされなくなりました。この影響を抑えるには、APLドキュメントのバージョンを1.6に変更してください。
-
［APL 1.6］画面付きのAlexa搭載デバイスにおいて、ビューポートとはユーザーに表示される画面領域のことを指します。それぞれのビューポートには、形状、向き、サイズ、密度があります。このサイズと密度は、プロファイルが複数の物理デバイスを表すことができるように範囲として定義されます。スキルマニフェストで、「デバイス、円、小」、「デバイス、横長、小」、「デバイス、横長、中」、「デバイス、横長、大」の各デバイスに対して、現在サポートされているビューポート範囲の代わりに手動で固定／過去のビューポートディメンション値を指定すると、開発者コンソールで対応するビューポートプロファイルのチェックボックスがオフになります。現時点でのベストプラクティスは、必要なビューポートプロファイルでAPLコンテンツが正しくレンダリングされるかどうかを確認した後、対応するビューポートプロファイルをコンソールで選択するか、対応するサポートされているビューポート範囲を手動でスキルマニフェストに指定することです。
-
［APL 1.7］Androidデバイスで、Alexa Vector Graphic（AVG）の放射グラデーションが、間違った半径、位置、スケーリングでレンダリングされることがなくなりました。
関連トピック
サポートとヘルプについては、Stack Overflowを参照してください。問題を報告するには、Alexa開発者サポートにお問い合わせください。
最終更新日: 2025 年 12 月 04 日