mx.core.SoundAsset (Flex™ 2 リファレンスガイド)

パッケージ	mx.core
	public class SoundAsset
継承	SoundAsset Sound EventDispatcher Object
Implements	IFlexAsset

SoundAsset は、Flex アプリケーションに埋め込まれたサウンドを表す Flash Player の Sound クラスのサブクラスです。

MP3 ファイルのサウンドを埋め込むことができます。Flash によって作成された SWF ファイルのサウンドシンボルを埋め込むこともできます。いずれのケースでも、MXML コンパイラは、埋め込まれたサウンドデータを表すように SoundAsset を拡張するクラスを自動生成します。

通常は、Flex アプリケーションを作成するときに SoundAsset クラスを直接使用する必要はありません。たとえば、次のように記述するだけで、MP3 ファイルを埋め込み、SoundEffect で使用することができます。

  <mx:SoundEffect id="beep" source="@Embed(source='Beep.mp3')"/>

MXML コンパイラによって SoundAsset のサブクラスが作成されたことを認識しておく必要はありません。

ただし、ActionScript レベルで何が行われているのかを理解しておくことは有益です。ビットマップを ActionScript に埋め込むには、Class 型の変数を宣言し、それに [Embed] メタデータを入れます。たとえば、このようにして MP3 ファイルを埋め込みます。

  [Bindable]
  [Embed(source="Beep.mp3")]
  private var beepClass:Class;

MXML コンパイラは、拡張子 .mp3 を確認し、MP3 データを Flash Player が使用するサウンド形式にトランスコードして、SoundAsset クラスのサブクラスを自動生成し、この自動生成されたクラスへの参照を変数に設定します。その後、このクラス参照を使用し、new 演算子を使用して SoundAsset のインスタンスを作成すること、およびそれらに Sound クラスの API を使用することができます。

    var beepSound:SoundAsset = SoundAsset(new beepClass());
    beepSound.play();

ただし、サウンド関連のプロパティおよびスタイルをサウンド生成クラスに設定でき、コンポーネントが必要に応じてサウンドインスタンスを作成するため、SoundAsset インスタンスを自分で作成する必要はほとんどありません。たとえば、このサウンドを SoundEffect で再生するために、SoundEffect の source プロパティを beepClass に設定することができます。MXML では、次のようにします。

  <mx:SoundEffect id="beepEffect" source="{beepClass}"/>

パブリックプロパティ

継承されるパブリックプロパティの非表示

継承されるパブリックプロパティの表示

	プロパティ		定義
		bytesLoaded : uint この Sound オブジェクトで現在利用できるデータのバイト数を返します。	Sound
		bytesTotal : int この Sound オブジェクトの合計バイト数を返します。	Sound
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		id3 : ID3Info MP3 ファイルの一部であるメタデータに対するアクセスを提供します。	Sound
		isBuffering : Boolean 外部 MP3 ファイルのバッファリング状態を返します。	Sound
		length : Number 現在のサウンドの継続時間を示すミリ秒数です。	Sound
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		url : String サウンドがロードされる URL です。	Sound

パブリック Methods

継承されるパブリックメソッドの非表示

継承されるパブリックメソッドの表示

	メソッド		定義
		SoundAsset() コンストラクタです。	SoundAsset
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void リスナーがイベントの通知を受け取るように、イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録します。	EventDispatcher
		close():void ストリームを閉じて、データのダウンロードを中止します。	Sound
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指定されたプロパティがオブジェクトに定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		load(stream:URLRequest, context:SoundLoaderContext = null):void 指定した URL から外部 MP3 ファイルのロードを開始します。	Sound
		play(startTime:Number = 0, loops:int = 0, sndTransform:SoundTransform = null):SoundChannel サウンドを再生する SoundChannel オブジェクトを新しく作成します。	Sound
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

継承されるイベントの非表示

継承されるイベントの表示

	一覧	定義
activate	Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
complete	データが正常にロードされたときに送出されます。	Sound
deactivate	Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
id3	MP3 サウンドで ID3 データを使用できる場合に、Sound オブジェクトによって送出されます。	Sound
ioError	入出力エラーが発生してロード操作が失敗したときに送出されます。	Sound
open	ロード操作が開始したときに送出されます。	Sound
progress	ロード処理を実行中にデータを受信したときに送出されます。	Sound

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class SoundAsset	プロパティ \| メソッド \| イベント