Audio(APL for Audio)



Audio(APL for Audio)

Audioコンポーネントは、MP3ファイルなど、提供されたオーディオファイルを再生します。

プロパティ

Audioコンポーネントには基本コンポーネントプロパティのほかに、コンポーネント固有の次のプロパティがあります。

プロパティ デフォルト 説明
source 文字列 "" 再生するリモートオーディオファイルのURLを指定します。

source

再生するリモートオーディオファイルのURLを指定します。URLは、要件を満たすオーディオファイルを参照する必要があります。

sourceプロパティは、1つのオーディオファイルを再生する1つのURLを受け入れます。連続したオーディオファイルを再生するには、Sequencerコンポーネントの子コンポーネントとしてAudioを使用します。

Alexa Skills Kitサウンドライブラリのサポート

Audioコンポーネントは、サウンドエフェクトの再生用にAlexa Skills Kitサウンドライブラリをサポートします。

サウンドライブラリドキュメントからサウンドのコードをコピーすると、コードには完全なSSML audioタグが含まれます。そこからサウンドのURLを抽出し、Audioコンポーネントのsourceプロパティに割り当てます。

たとえば、サウンド「nature_08」をコピーすると次のSSMLコードが含まれます。

<audio src="soundbank://soundlibrary/water/nature/nature_08"/>

これをAudioコンポーネントで使用するには、次のように、URL soundbank://soundlibrary/water/nature/nature_08sourceプロパティに割り当てます。

クリップボードにコピーされました。

{
  "type": "Audio",
  "source": "soundbank://soundlibrary/water/nature/nature_08"
}

オーディオファイルのサポート

Audioコンポーネントで使用するオーディオファイルは、次の要件を満たす必要があります。

オーディオ入力の形式

Audioコンポーネントは、次の形式のオーディオファイルをサポートします。

  • aac
  • mp3
  • ogg
  • opus
  • wav

オーディオ入力の要件

オーディオファイルは次の要件を満たす必要があります。

  • ビットレート – ビットレートは1411.20 kbps以下である必要があります。
  • サンプルレート – サンプルレートは48kHz以下である必要があります。
  • ファイルサイズ – オーディオクリップのファイルサイズは10MBを超えないようにします。ファイルサイズが10MBを超える場合、ファイルの再生時間を編集するか、MP3やOpusなど、別の形式に変換することを検討してください。
  • 応答の長さ – コンポーネントを組み合わせて生成したオーディオ応答全体の合計時間が、240秒を超えることはできません。

URLの要件

Audioコンポーネントの「source」プロパティなど、APLAドキュメントで指定されるすべてのURLは、次の要件に準拠する必要があります。

  • HTTPS – オーディオファイルは、インターネットにアクセス可能なHTTPSエンドポイント側でホスティングされる必要があります。
  • SSL証明書 – オーディオファイルをホストするドメインは、有効で、信頼できるSSL証明書を提示する必要があります。自己署名証明書は使用できません。APL、Alexaスキルの両方が、同じ信頼されたCAのリストを使用する必要があります。 Mozillaからの信頼されたCAのリスト
  • CORSワイルドカード – オーディオファイルはCORSのワイルドカードに対応している必要があります。サービスは、次のヘッダーで応答する必要があります: Access-Control-Allow-Origin: *

サポートされているチャンネルレイアウト

APLレンダリングエンジンは、入力として次のチャンネルレイアウトをサポートします。

  • mono
  • stereo

同時にミキシング可能なオーディオソースの最大数

どの時点においても、同時にミキシングできるオーディオソースは4つまでです。

以下は、指定されたURLに保存された熱帯雨林サウンドを再生する例です。この例では、URL https://example.com/mySampleAudio/rainforestSoundEffect.mp3のオーディオファイルがオーディオファイルのサポートに記載された要件を満たす必要があります。

クリップボードにコピーされました。

{
  "type": "Audio",
  "source": "https://example.com/mySampleAudio/rainforestSoundEffect.mp3"
}

以下は、ASKサウンドライブラリで提供された鳥のサウンドエフェクトを再生する例です。

クリップボードにコピーされました。

{
  "type": "Audio",
  "source": "soundbank://soundlibrary/animals/amzn_sfx_bird_forest_02"
}