パッケージmx.core
クラスpublic class SoundAsset
継承SoundAsset Inheritance Sound Inheritance EventDispatcher Inheritance Object
実装 IFlexAsset

SoundAsset は、Flex アプリケーションに埋め込まれたサウンドを表す flash.media.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 データを 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}"/>


パブリックプロパティ
 プロパティ定義元
 InheritedbytesLoaded : uint
[読み取り専用] この Sound オブジェクトで現在利用できるデータのバイト数を返します。
Sound
 InheritedbytesTotal : int
[読み取り専用] この Sound オブジェクトの合計バイト数を返します。
Sound
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedid3 : ID3Info
[読み取り専用] MP3 ファイルの一部であるメタデータに対するアクセスを提供します。
Sound
 InheritedisBuffering : Boolean
[読み取り専用] 外部 MP3 ファイルのバッファリング状態を返します。
Sound
 Inheritedlength : Number
[読み取り専用] 現在のサウンドの継続時間を示すミリ秒数です。
Sound
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedurl : String
[読み取り専用] サウンドがロードされる URL です。
Sound
パブリックメソッド
 メソッド定義元
  
SoundAsset()
コンストラクタです。
SoundAsset
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
close():void
ストリームを閉じて、データのダウンロードを中止します。
Sound
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
extract(target:ByteArray, length:Number, startPosition:Number = -1):Number
Sound オブジェクトから生のサウンドデータを抽出します。
Sound
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
load(stream:URLRequest, context:SoundLoaderContext = null):void
指定した URL から外部 MP3 ファイルのロードを開始します。
Sound
 Inherited
play(startTime:Number = 0, loops:int = 0, sndTransform:SoundTransform = null):SoundChannel
サウンドを再生する SoundChannel オブジェクトを新しく作成します。
Sound
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
complete
データが正常にロードされたときに送出されます。Sound
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited
id3
MP3 サウンドで ID3 データを使用できる場合に、Sound オブジェクトによって送出されます。Sound
 Inherited
ioError
入出力エラーが発生して読み込み操作が失敗したときに送出されます。Sound
 Inherited
open
読み込み操作が開始したときに送出されます。Sound
 Inherited
progress
ロード処理の実行中にデータを受信したときに送出されます。Sound
 Inherited
sampleData
Flash Player が新しいオーディオデータを要求するときに送出されます。Sound
コンストラクタの詳細
SoundAsset()コンストラクタ
public function SoundAsset()

コンストラクタです。




© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/core/SoundAsset.html