パッケージflash.media
public final class SoundMixer
継承SoundMixer Inheritance Object

SoundMixer クラスには、静的プロパティや SWF ファイルのグローバルサウンドコントロールのメソッドが含まれます。SoundMixer クラスは、SWF に埋め込まれたストリーミングサウンドを制御しますが、動的に作成される Sound オブジェクト (ActionScript で作成される Sound オブジェクト) は制御しません。



パブリックプロパティ
 プロパティ定義
  bufferTime : int
[static] サウンドのストリーミングを開始するまでに、バッファに埋め込まれたストリーミングサウンドをプリロードする秒数です。
SoundMixer
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  soundTransform : SoundTransform
[static] グローバルサウンドプロパティを制御する SoundTransform オブジェクトです。
SoundMixer
パブリック Methods
 メソッド定義
  
[static] セキュリティ上の制限のためにサウンドが使用できないかどうかを調べます。
SoundMixer
  
computeSpectrum(outputArray:ByteArray, FFTMode:Boolean = false, stretchFactor:int = 0):void
[static] 現在のサウンド波形からスナップショットを取得し、指定した ByteArray オブジェクトに配置します。
SoundMixer
 Inherited
指定されたプロパティがオブジェクトに定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
[static] 再生中のサウンドをすべて停止します。
SoundMixer
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
bufferTimeプロパティ
bufferTime:int  [read-write]

サウンドのストリーミングを開始するまでに、バッファに埋め込まれたストリーミングサウンドをプリロードする秒数です。ロードされたサウンドのデータ (バッファ時間も含む) には、クロスドメインポリシーファイルを実装していない限り、別のドメインに存在する SWF ファイルからアクセスできません。セキュリティとサウンドの詳細については、Sound クラスの説明を参照してください。

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

実装
    public static function get bufferTime():int
    public function set bufferTime(value:int):void

関連項目

soundTransformプロパティ 
soundTransform:SoundTransform  [read-write]

グローバルサウンドプロパティを制御する SoundTransform オブジェクトです。SoundTransform オブジェクトには、ボリューム、パン、左スピーカーの割り当て、および右スピーカーの割り当てを設定するプロパティが含まれます。SoundTransform オブジェクトは、SWF ファイル内に埋め込まれたサウンドのみに影響します。個々のサウンド設定が適用された後に、このプロパティで使用される SoundTransform オブジェクトで最終的にすべてのサウンドを設定します。

実装
    public static function get soundTransform():SoundTransform
    public function set soundTransform(value:SoundTransform):void

関連項目

メソッドの詳細
areSoundsInaccessible()メソッド
public static function areSoundsInaccessible():Boolean

セキュリティ上の制限のためにサウンドが使用できないかどうかを調べます。たとえば、SWF ファイルが存在するドメインからのアクセスを許可するクロスドメインポリシーファイルが、サウンドのサーバー上に存在しないとします。サウンドは SWF ファイルのドメイン以外のドメインからロードされているため、アクセスできません。サウンドをロードしたり、再生することはできますが、アクセス不可のサウンドに対して、サウンドの ID3 メタデータの取得などの低レベルの操作は実行できません。

戻り値
Boolean

関連項目

computeSpectrum()メソッド 
public static function computeSpectrum(outputArray:ByteArray, FFTMode:Boolean = false, stretchFactor:int = 0):void

現在のサウンド波形からスナップショットを取得し、指定した ByteArray オブジェクトに配置します。値の形式は正規化された浮動小数値で、範囲は -1.0 ~ 1.0 です。outputArray パラメータに渡す ByteArray オブジェクトは、新しい値で上書きされます。作成される ByteArray オブジェクトのサイズは 512 に固定され (値は浮動小数値)、最初の 256 個は左チャネルを表し、次の 256 個は右チャネルを表します。

メモ : このメソッドにはローカルファイルのセキュリティ制限、およびドメイン間のデータロードに関する制限が適用されます。ローカルの SWF ファイルを操作する場合、または SWF を呼び出さずに別のドメインに存在するサーバーからロードしたサウンドを操作する場合は、クロスドメインポリシーファイルによるサンドボックスの制限への対応が必要となる場合があります。詳細については、Sound クラスの説明を参照してください。また、このメソッドは、RTMP サーバーと同じドメインに存在する SWF ファイルから呼び出された場合でも、RTMP ストリームからデータを抽出するために使用することはできません。

パラメータ
outputArray:ByteArray — サウンドに関連する値を保持する ByteArray オブジェクトです。セキュリティ上の制限のためにサウンドが使用できない場合 (areSoundsInaccessible == true)、outputArray オブジェクトは変更されません。すべてのサウンドを停止した場合、outputArray オブジェクトには 0 が詰められます。
 
FFTMode:Boolean (default = false) — サウンドデータに対して最初にフーリエ変換を実行するかどうかを示すブール値です。このパラメータを true に設定すると、このメソッドは未処理のサウンド波形ではなく周波数スペクトルを返します。周波数スペクトルでは、低い周波数は左側に、高い周波数は右側に表されます。
 
stretchFactor:int (default = 0) — サウンドサンプリングの解像度です。たとえば、stretchFactor 値に 0 を設定した場合、データは 44.1 KHz でサンプリングされ、1 の場合は 22.05 KHz、2 の場合は 11.025 KHz となります。

関連項目

stopAll()メソッド 
public static function stopAll():void

再生中のサウンドをすべて停止します。

再生ヘッドは停止されません。ストリーミングするために設定されたサウンドは、そのサウンドが置かれているフレームに再生ヘッドが移動すると再生を再開します。

このプロパティを使用するときは、Flash Player セキュリティモデルを考慮してください。

詳細については、次の参照先を参照してください。