Alexa Presentation Languageの既知の問題



Alexa Presentation Languageの既知の問題

Alexa Presentation Language(APL)の既知の問題、バグと変更点については、以下の一覧を参照してください。

既知の問題

  • [Echo Show 10] Echo Show 10デバイス上で起動すると、スキルマニフェストまたは開発者コンソールのインターフェースタブで"Wake Word Response"を設定しているスキルがクラッシュすることがあります。これを修正するための緊急のパッチは、数日以内に展開される予定です。その間、Echo Show 10の問題の回避策を参照してください。

  • VectorGraphicリニアグラデーションは、オーサリングツールと物理デバイスで異なって見えます。

  • [タブレット] AlexaImageList: 縦長の10インチデバイスでは、無効なリスト項目の動作が崩れます

  • 物理デバイスでは、FrameImageコンポーネントが含まれている場合、FrameborderRadiusプロパティがFrameのコーナーを正しく調整しません。

  • [Fire TV Editions TV] 音量パネルを閉じた後、レシピ動画が元の音量に戻りません

  • <nobr>タグの前の改行箇所が正しく改行しません

  • <nobr>を含むテキストはコンテナの最後で不正に折り返します。

  • [APLシミュレーター] [大型/超大型TVハブ] autoplayfalsetrueシナリオの両方でビデオが再生されません

  • Videoコンポーネントを使用して width/heightを0に設定してオーディオを再生するAPLドキュメントは動作を停止します。この問題を回避するには、 width/heightを1に設定します。

Echo Show 10の問題の回避策

Echo Show 10デバイスで起動すると、スキルマニフェストまたは開発者コンソールのインターフェースタブで"Wake Word Response"を設定するスキルがクラッシュすることがあります。これを修正するための緊急のパッチは、数日以内に展開される予定です。その間、次の手順で問題を軽減します。

問題を軽減するには

  1. ASK CLIがインストールされ、設定されていることを確認します。詳細については、クイックスタート: Alexa Skills Kitコマンドラインインターフェース(ASK CLI)の手順に従ってASK CLIをインストールします。

  2. 次のコマンドを実行して、スキルのマニフェストを取得します。

    ask smapi get-skill-manifest -s [スキルID] -g development > manifest.json

    [スキルID]をスキルのIDに置き換えます。

  3. CLIによって生成されたmanifest.jsonファイルを開きます。manifest.apis.custom.interfaces配列で、タイプがALEXA_EXTENSIONのインターフェイスを探します。

  4. ALEXA_EXTENSIONオブジェクトで、autoInitializedExtensionsという配列を削除し、manifest.jsonを保存します。

  5. 次のコマンドを実行して、スキルのマニフェストを更新します。

    ask smapi update-skill-manifest -s [スキルID] -g development --manifest "file:manifest.json"

    このコマンドは非同期操作です。コマンドが機能したことを確認するには、ASK開発者コンソールを開き、インターフェースタブを開きます。Wake Word Responseボックスが空で、Alexa Extenstionsが選択されていないことを確認します。

  6. Echo Show 10でスキルの開発バージョンを再テストし、スキルがクラッシュしなくなったことを確認します。

    Wake Word ResponseをFollow On Wake Wordに設定していた場合は、Follow On Wake WardはEcho Showの初期設定の動作であるため、動作の不具合は起きません。

  7. スキルで問題が解決した場合は、開発者コンソールのインターフェースページを開き、公開中のスキルの更新をクリックします。

    この操作により、公開中スキルのマニフェストが更新され、公開中のスキルの問題が解決されます。

    公開中のスキルの更新が無効になっている場合は、スキルを再提出して認定を受けてください。テスト手順には、スキルマニフェストからデフォルトのウェイクワードレスポンスを削除したこと、Alexa APIの既知の問題に対応するための変更であることを記載してください。この既知の問題のページを参照できるように、https://developer.amazon.com/ja-JP/docs/alexa/alexa-presentation-language/apl-known-issues.html#workaround-echo-show-10のリンクを含めてください。

機能の変更

  • [APL 1.6] Echo Show 8はデバイス、横長、中デバイスとして扱います。Echo Show 8に関するユーザーからのフィードバックは、多くのAlexaエクスペリエンスでフォントサイズが小さいことを示しています。これに対処するために、デバイスが画面サイズを報告する方法が更新されました。その結果、デバイスは「デバイス、横長、大」ではなく「デバイス、横長、中」として分類します。この変更に対応するには、Alexa開発者コンソールのインターフェースページを確認し、「デバイス、横長、中」がチェックされていることを確認することをお勧めします。また、サポートしているその他のViewportのすべてのボックスも確認してください。既存のスキルには影響しません。Echo Show 8は、サポートされているViewportプロファイルとして「デバイス、横長、中」にオプトインするチェックボックスをオンにするまで、引き続き「デバイス、横長、大」として表示されます。

  • [APL 1.6] FireTVの方向キーで、バージョン1.6よりも前のAPLドキュメントでページャーがアニメーション化されなくなります。対応するには、APLドキュメントのバージョンを1.6に変更します。

  • 画面付きのAlexa搭載デバイスでは、「Viewport」はユーザーに表示される画面領域のことを指します。それぞれのViewportには、形状、向き、サイズ、密度があります。このサイズと密度は、プロファイルが複数の物理デバイスを表すことができるように範囲として定義されます。次のデバイスのスキルマニフェストで、現在サポートされているviewport範囲ではなく、固定/レガシーのviewport寸法値を手動で指定すると、開発者コンソールで対応するviewportプロファイルのチェックボックスはチェックされません:「デバイス、円、小」、「デバイス、横長、小」、「デバイス、横長、中」、「デバイス、横長、大」現在のベストプラクティスは、APLコンテンツが必要なviewportプロファイルで正しくレンダリングされるかどうかを確認し、コンソールで対応するviewportプロファイルを選択するか、サポートされているviewport範囲をスキルマニフェストで手動で指定することです。

  • [APL 1.7] AVG放射状グラデーションがAndroidデバイス上で間違った半径、位置、またはスケーリングでレンダリングされなくなりました。


サポートとヘルプについては、Alexa開発者フォーラムを参照してください。お問い合わせを選択して、問題を報告してください。

最終更新日:2021年9月29日