オーサリングツールでAPLサンプルをテストする
Alexa Presentation Languageの技術資料には、APLドキュメントとデータソースを作成する方法を説明したJSONサンプルを含むトピックがあります。これらのサンプルをAPLオーサリングツールにコピーして動作を確認し、自分で変更を加えて試してみることができます。これらのサンプルのほとんどは、実際に動作するスキルがなくてもテストできます。
APLサンプルコードについて
APLドキュメント全体のサンプルには、APLドキュメントとデータソースという2つの部分が含まれます。サンプルの動作を確認するには、これらの両方をオーサリングツールにコピーする必要があります。
長いサンプルはページ上で折りたたまれています。ボタンをクリックして、コードを展開してください。
たとえば、以下のようなボタンが表示されることがあります。ドキュメント全体を表示するには、サンプルドキュメント： AlexaHeadlineの例をクリックします。データソース全体を表示するには、データソース：headlineExampleDataを参照します。
APLドキュメントには、ドキュメント全体のサンプルと小さいコードスニペットの両方が含まれています。サンプルがドキュメント全体かどうかを判断するには、typeプロパティがAPLに設定されているかどうかを確認してください。ドキュメント全体のサンプルには、必ずこのプロパティが含まれています。
ドキュメント全体とデータソース全体をオーサリングツールにコピーする
APLオーサリングツールを使用すると、APLドキュメントとそれに関連するデータソースを作成して、さまざまなViewportでの見え方をプレビューできます。開発者コンソールでスキルからオーサリングツールを開くと、APLドキュメントをスキルに保存して、後でまた作業に戻ることができます。
ツールの使用方法については、開発者コンソールでドキュメントを作成するを参照してください。
ドキュメント全体は、必ずtypeプロパティで始まり、このプロパティはAPLに設定されています。
ドキュメント全体をオーサリングツールにコピーするには
- 技術資料の各ページで、必要に応じてサンプルコードを展開します。
-
コードをコピーボタンをクリックします。
APL JSONサンプルのコードをコピーするボタン - 別のブラウザウィンドウで、開発者コンソールを開きます。
- 既存のスキルを開くか、新しいスキルを作成します。オーサリングツールは、実際に動作するエンドポイントがスキルになくても使用できます。
-
左側のナビゲーションから、マルチモーダル応答をクリックします。
新しいウィンドウかタブでオーサリングツールが開き、このスキルに保存されている既存のドキュメントが表示されます。
- 視覚をクリックします。
- 視覚応答を作成をクリックします。
- 空のドキュメントをクリックします。これにより、新しい空のAPLドキュメントとデータソースが作成されます。
- コードビューをクリックします。
-
編集ペインから既存のJSONコードをすべて削除し、ステップ2でコピーしたコードを貼り付けます。
プレビューペインには空白のドキュメントが表示されることがあります。これはデータが存在しないためです。
- 次で説明するように、データソースをコピーします。
通常、ドキュメントのデータソースは、そのトピックのドキュメントの後にあります。JSONは、1つ以上のキー／オブジェクトのペアを持つオブジェクトです。たとえば、次のデータソースはheadlineExampleDataと呼ばれます。
{
"headlineExampleData": {
"property": "value"
}
}
データソースをオーサリングツールにコピーするには
- 技術資料の各ページで、必要に応じてデータソースのサンプルを展開します。
- コードをコピーボタンをクリックします。
- オーサリングツールに戻り、前に作成したAPLドキュメントに戻ります。
- ツールバーで、DATAボタン（
）をクリックします。 - 編集ペインから既存のコンテンツを削除し、ステップ2でコピーしたコードを貼り付けます。
この時点で、プレビューペインに完全なドキュメントが表示されます。コンポーネントとデータを変更して試し、サンプルの動作を確認します。
オーサリングツールのライブプレビューモードを使用する
一部のAPL機能は、オーサリングツールのライブプレビューモードを使用してプレビューする必要があります。ライブプレビューモードをクリックしてプレビューモードを開始します。オーサリングツールでサポートされる機能の詳細については、タップイベント、コマンド、ビデオをプレビューするを参照してください。
関連トピック
最終更新日: 2025 年 12 月 02 日