SoundAsset

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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}"/>

パブリックプロパティ

継承されるパブリックプロパティを隠す

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

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

パブリックメソッド

継承されるパブリックメソッドを隠す

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

	メソッド		定義元
		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
		extract(target:ByteArray, length:Number, startPosition:Number = -1):Number Sound オブジェクトから生のサウンドデータを抽出します。	Sound
		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
		loadCompressedDataFromByteArray(bytes:ByteArray, bytesLength:uint):void MP3 サウンドデータを ByteArray オブジェクトから Sound オブジェクトにロードします。	Sound
		loadPCMFromByteArray(bytes:ByteArray, samples:uint, format:String = "float", stereo:Boolean = true, sampleRate:Number = 44100.0):void PCM 32 ビット浮動小数点のサウンドデータを ByteArray オブジェクトから Sound オブジェクトにロードします。	Sound
		play(startTime:Number = 0, loops:int = 0, sndTransform:flash.media: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
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

イベントの詳細についてはここをクリックしてください

継承されるイベントを隠す

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

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

コンストラクターの詳細

()

コンストラクター

public function SoundAsset()

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

コンストラクターです。

法律上の注意 | プライバシーポリシー

SoundAsset - AS3 Flex

クラス x

SoundAsset