サウンドのストリーミングを開始するまでに、バッファにストリーミングサウンドをプリロードする秒数です。

SoundLoaderContext.bufferTime の値を、グローバル SoundMixer.bufferTime プロパティを設定してオーバーライドすることはできません。SoundMixer.bufferTime プロパティは SWF に埋め込まれたストリーミングサウンドのバッファ時間に影響し、動的に作成される Sound オブジェクト (ActionScript で作成される Sound オブジェクト) には影響しません。

サウンドのロードを開始する前に、Flash Player が、ロードされるサウンドのサーバーからのクロスドメインポリシーファイルのダウンロードを試行するかどうかを指定します。このプロパティは、呼び出し元の SWF ファイル自身のドメイン外から Sound.load() メソッドを使用してロードされたサウンドに適用されます。

呼び出し元の SWF ファイル自身のドメイン外からサウンドをロードし、ActionScript から低レベルでサウンドにアクセスする必要がある場合は、このプロパティを true に設定します。サウンドデータへの低レベルアクセスの例です。ID3Info オブジェクトを取得するための Sound.id3 プロパティへの参照、またはロードされたサウンドからサウンドサンプリングを取得する SoundMixer.computeSpectrum() メソッドの呼び出しが含まれます。ロード時に checkPolicyFile プロパティを true に設定せずにサウンドデータにアクセスしようとした場合、必要なポリシーファイルがダウンロードされていないために SecurityError 例外を受け取る場合があります。

ロードするサウンドデータへの低レベルのアクセスを必要としない場合は、checkPolicyFile を true に設定しないでください。ポリシーファイルの確認はネットワーク帯域幅の浪費になり、ダウンロードの開始が遅れる場合があるため、必要な場合にのみ行います。

Sound.load() を呼び出すときに SoundLoaderContext.checkPolicyFile を true に設定すると、Flash Player は、関連するクロスドメインポリシーファイルを正常にダウンロードするか、指定されたサウンドのダウンロードを開始する前に、そのようなポリシーファイルが存在しないことを判別する必要があります。ポリシーファイルの存在を確認するため、Flash Player は次のアクションをこの順番で実行します。

• Flash Player は、既にダウンロードされているポリシーファイルを考慮します。
• Flash Player は、Security.loadPolicyFile() の呼び出しで指定された保留されているポリシーファイルのダウンロードを試行します。
• Flash Player はサウンドの URL に対応するデフォルトの場所からポリシーファイルをダウンロードしようとします。これは /crossdomain.xml で、URLRequest.url と同じサーバーにあります。サウンドの URL は URLRequest オブジェクトの url プロパティで指定します。URLRequest オブジェクトは Sound.load() または Sound コンストラクタに渡されます。

どのような場合でも、Flash Player では、適切なポリシーファイルがサウンドのサーバー上に存在しており、ポリシーファイルの場所に応じて URLRequest.url にあるサウンドファイルへのアクセスが提供され、<allow-access-from> タグに応じて呼び出し元 SWF ファイルのドメインによるアクセスが許可されている必要があります。

checkPolicyFile を true に設定した場合、Flash Player はサウンドをロードする前に、ポリシーファイルが検証されるまで待機します。サウンドデータに対する低レベルの操作 (Sound.id3 の呼び出しまたは SoundMixer.computeSpectrum() の呼び出しなど) の実行を、Sound オブジェクトから progress イベントおよび complete イベントが送出されるまで、待つ必要があります。

checkPolicyFile を true に設定していても、適切なポリシーファイルが見つからない場合は、ポリシーファイルを必要とする操作を実行するまでエラーが表示されません。ポリシーファイルが必要になると、Flash Player は SecurityError 例外をスローします。complete イベントを受け取ると、Sound.id3 の値 (try ブロック内) を取得して SecurityError がスローされたかどうかを確認し、関連するポリシーファイルが見つかったかどうかをテストできます。

サーバーサイド HTTP リダイレクトを使用する URL からサウンドをダウンロードする場合は、checkPolicyFile に注意してください。Flash Player は、URLRequest オブジェクトの url プロパティに対応するポリシーファイルを取得しようとします。URLRequest オブジェクトは Sound.load() に渡されます。最終的なサウンドファイルが HTTP リダイレクトによって別の URL から取得される場合、最初にダウンロードされたポリシーファイルはサウンドの最終的な URL に適用できないことがあります。そのため、URL はセキュリティ判定において重要です。

このような状況になった場合の解決方法が 1 つあります。progress イベントまたは complete イベントを受け取った後、Sound.url プロパティの値を調べることができます。ここには、サウンドの最終的な URL が格納されています。次に、サウンドの最終的な URL に基づいて算出したポリシーファイルの URL で Security.loadPolicyFile() メソッドを呼び出します。最後に、例外がスローされなくなるまで Sound.id3 の値をポーリングします。

ポリシーファイルの詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。

関連項目

新しい ContextMenu オブジェクトを作成します。

package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;
    import flash.media.SoundLoaderContext;
    import flash.events.IOErrorEvent;
    
    public class SoundLoaderContextExample extends Sprite {

        public function SoundLoaderContextExample() {
            var snd:Sound = new Sound();
            var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
            var context:SoundLoaderContext = new SoundLoaderContext(30000, false);

            snd.load(req, context);
            snd.play();      
 
            snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
        }

        private function errorHandler(errorEvent:IOErrorEvent):void {
            trace("The sound could not be loaded: " + errorEvent.text);
        }

    }
}