flash.media.Sound (Flex™ 2 リファレンスガイド)

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

	メソッド	定義
		Sound(stream:URLRequest = null, context:SoundLoaderContext = null) 新しい Sound オブジェクトを作成します。	Sound
		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

プロパティの詳細

bytesLoaded

プロパティ

bytesLoaded:uint [read-only]

この Sound オブジェクトで現在利用できるデータのバイト数を返します。これは通常、外部からロードするファイルのみに使用します。

実装
public function get bytesLoaded():uint

bytesTotal

プロパティ

bytesTotal:int [read-only]

この Sound オブジェクトの合計バイト数を返します。

実装
public function get bytesTotal():int

id3

プロパティ

id3:ID3Info [read-only]

MP3 ファイルの一部であるメタデータに対するアクセスを提供します。

MP3 サウンドファイルには、ファイルについてのメタデータを示す ID3 タグを含めることができます。Sound.load() メソッドを使用してロードした MP3 サウンドに ID3 タグが含まれる場合は、これらのプロパティを調べることができます。サポートされているのは、UTF-8 文字セットを使用する ID3 タグだけです。

Flash Player 9 以降では、ID3 2.0 (厳密には 2.3 および 2.4) のタグのサポートが追加されました。次の表に、標準の ID3 2.0 タグと、そのタグが表すコンテンツタイプを示します。Sound.id3 プロパティは my_sound.id3.COMM、my_sound.id3.TIME などの形式を使用してこれらのタグにアクセスできます。最初の表は、ID3 2.0 プロパティ名または ActionScript プロパティ名のいずれかを使用してアクセスできるタグを示します。2 番目の表は、サポートされているものの、ActionScript に定義済みのプロパティが存在しない ID3 タグを示します。

ID3 2.0 タグ	対応する ActionScript プロパティ
COMM	Sound.id3.comment
TALB	Sound.id3.album
TCON	Sound.id3.genre
TIT2	Sound.id3.songName
TPE1	Sound.id3.artist
TRCK	Sound.id3.track
TYER	Sound.id3.year

次の表は、サポートされているものの、ActionScript に定義済みのプロパティが存在しない ID3 タグを示します。これらのタグにアクセスするには、mySound.id3.TFLT、mySound.id3.TIME などを呼び出します。

プロパティ	内容
TFLT	ファイル形式
TIME	時刻
TIT1	内容の属するグループの説明
TIT2	タイトル/曲名/内容の説明
TIT3	サブタイトル/説明の追加情報
TKEY	最初の調
TLAN	言語
TLEN	長さ
TMED	メディアタイプ
TOAL	オリジナルのアルバム/ムービー/ショーのタイトル
TOFN	オリジナルのファイル名
TOLY	オリジナルの作詞家/文書作成者
TOPE	オリジナルのアーティスト/演奏者
TORY	オリジナルのリリース年
TOWN	ファイルの所有者/ライセンス保持者
TPE1	主な演奏者/ソリスト
TPE2	バンド/オーケストラ/伴奏
TPE3	指揮者/演奏者詳細情報
TPE4	翻訳、リミックス、その他の修正を行った人
TPOS	セット中の位置
TPUB	発行者
TRCK	トラック番号/セット内の位置
TRDA	録音日
TRSN	インターネットラジオ局の名前
TRSO	インターネットラジオ局の所有者
TSIZ	サイズ
TSRC	ISRC (国際標準録音資料コード)
TSSE	エンコードに使用したソフトウェア/ハードウェアと設定
TYER	年
WXXX	URL リンクフレーム

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

Sound オブジェクトの id3 プロパティは、サウンドファイルと同じセキュリティサンドボックス内にある SWF ファイルで常に使用できます。他のサンドボックス内のファイルには、セキュリティチェックがあります。
サウンドをロードするとき、Sound クラスの load() メソッドを使用すると、SoundLoaderContext オブジェクトである context パラメータを指定できます。SoundLoaderContext オブジェクトの checkPolicyFile プロパティを true に設定した場合、Flash Player は、サウンドがロードされるサーバー上にクロスドメインポリシーファイルがあるかどうかをチェックします。クロスドメインポリシーファイルが存在しており、そのファイルでロード元 SWF ファイルのドメインが許可されている場合、Sound オブジェクトの id3 プロパティにアクセスできます。それ以外の場合は、アクセスできません。

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

『ActionScript 3.0 のプログラミング』のセキュリティの章と LiveDocs の最新コメント

Flash Player 9 セキュリティに関するホワイトペーパー

実装
public function get id3():ID3Info

関連項目

SoundLoaderContext.checkPolicyFile

isBuffering

プロパティ

isBuffering:Boolean [read-only]

外部 MP3 ファイルのバッファリング状態を返します。値が true の場合、再生は現在中断され、オブジェクトがデータを待機しています。

実装
public function get isBuffering():Boolean

length

プロパティ

length:Number [read-only]

現在のサウンドの継続時間を示すミリ秒数です。

実装
public function get length():Number

url

プロパティ

url:String [read-only]

サウンドがロードされる URL です。このプロパティは Sound.load() メソッドを使用してロードされた Sound オブジェクトにのみ適用できます。SWF ライブラリのサウンドアセットに関連付けられた Sound オブジェクトの url プロパティの値は null です。

初めて Sound.load() を呼び出す際は最終的な URL が不明なため、url プロパティの初期値は null になります。Sound オブジェクトから open イベントが送出されると同時に、url プロパティは null 以外の値になります。

url プロパティには、サウンドがロードされる最終的な、絶対 URL が格納されます。url の値は、通常、Sound.load() の stream パラメータに渡される値と同じです。ただし、Sound.load() に相対 URL を渡しても、url プロパティの値は絶対 URL を表します。また、元の URL 要求が HTTP サーバーによってリダイレクトされると、url プロパティの値はサウンドが実際にダウンロードされる URL を示します。この最終的な絶対URL の報告は、LoaderInfo.url の動作と同じです。

実装
public function get url():String

コンストラクタの詳細

Sound

()

コンストラクタ

public 関数 Sound(stream:URLRequest = null, context:SoundLoaderContext = null)

新しい Sound オブジェクトを作成します。Sound コンストラクタに有効な URLRequest オブジェクトを渡すと、コンストラクタは自動的に Sound オブジェクトの load() 関数を呼び出します。Sound コンストラクタに有効な URLRequest オブジェクトを渡さない場合は、ユーザー自身が Sound オブジェクトの load() 関数を呼び出す必要があります。呼び出さないと、ストリームがロードされません。

Sound オブジェクトで load() が呼び出された後は、その Sound オブジェクトに別のサウンドファイルをロードすることはできません。別のサウンドファイルをロードするには、新しい Sound オブジェクトを作成します。

パラメータ

	`stream:URLRequest` (default = `null`) — 外部の MP3 ファイルを指定する URL です。

	`context:SoundLoaderContext` (default = `null`) — Sound オブジェクトのバッファで MP3 データを保持する最小時間 (ミリ秒単位) です。Sound オブジェクトは、再生の開始前、ならびにネットワーク停止後の再生の再開前に少なくともこの大量のデータを取得するまで待機します。デフォルト値は 1000 ミリ秒 (1 秒) です。

メソッドの詳細

()

メソッド

public function close():void

ストリームを閉じて、データのダウンロードを中止します。close() メソッドの呼び出し後は、ストリームからデータを読み込みません。

スロー

IOError — ストリームを閉じることができないか、またはストリームが開いていません。.

load

()

メソッド

public function load(stream:URLRequest, context:SoundLoaderContext = null):void

指定した URL から外部 MP3 ファイルのロードを開始します。Sound コンストラクタに有効な URLRequest オブジェクトを渡すと、コンストラクタは Sound.load() を呼び出します。Sound コンストラクタに有効な URLRequest オブジェクトを渡さない場合、または null 値を渡す場合にのみ、ユーザー自身で Sound.load() を呼び出す必要があります。

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

呼び出し元 SWF ファイルがローカルファイルシステムのサンドボックスにあり、サウンドがネットワーク上のサンドボックスにある場合、Sound.load() を呼び出すことはできません。
信頼できるローカルのサンドボックスまたはネットワーク接続したローカルのサンドボックスからアクセスするには、クロスドメインポリシーファイルを使用して Web サイトで許可する必要があります。
SWF コンテンツを含む HTML ページの object タグおよび embed タグの allowNetworking パラメータを設定することで、SWF ファイルがこのメソッドを使用しないようにできます。

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

『ActionScript 3.0 のプログラミング』のセキュリティの章と LiveDocs の最新コメント

Flash Player 9 セキュリティに関するホワイトペーパー

パラメータ

	`stream:URLRequest` — 外部の MP3 ファイルを指定する URL です。

	`context:SoundLoaderContext` (default = `null`) — Sound オブジェクトのバッファで MP3 データを保持する最小時間 (ミリ秒単位) です。Sound オブジェクトは、再生の開始前、ならびにネットワーク停止後の再生の再開前に少なくともこの大量のデータを取得するまで待機します。デフォルト値は 1000 ミリ秒 (1 秒) です。

スロー

	`IOError` — このロードの失敗原因であるネットワークエラーです。

	`SecurityError` — 信頼されていないローカル SWF はインターネットへの接続を許可されません。これは、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類すると回避できる場合があります。

関連項目

Flash Player セキュリティ

play

()

メソッド

public function play(startTime:Number = 0, loops:int = 0, sndTransform:SoundTransform = null):SoundChannel

サウンドを再生する SoundChannel オブジェクトを新しく作成します。このメソッドは SoundChannel オブジェクトを返します。このオブジェクトにアクセスして、サウンドの停止、およびボリュームの監視を行います。ボリュームの制御、パン、バランスの設定を行うには、サウンドチャネルに割り当てられた SoundTransform オブジェクトにアクセスします。

パラメータ

	`startTime:Number` (default = `0`) — 再生を開始する初期位置 (ミリ秒単位) です。

	`loops:int` (default = `0`) — サウンドチャネルが再生を停止する前にサウンドをループ再生する回数を定義します。

	`sndTransform:SoundTransform` (default = `null`) — サウンドチャネルに割り当てられた初期 SoundTransform オブジェクトです。

戻り値

SoundChannel — サウンドの制御に使用する SoundChannel オブジェクトです。このメソッドは、サウンドカードがない場合、または使用できるサウンドチャネルが不足した場合は null を返します。一度に使用できるサウンドチャネルの最大数は 32 チャネルです。

イベントの詳細

complete

event

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.COMPLETE

データが正常にロードされたときに送出されます。

complete イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	ロードが完了したネットワークオブジェクトです。

関連項目

Sound.load()

id3

event

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.ID3

MP3 サウンドで ID3 データを使用できる場合に、Sound オブジェクトによって送出されます。

id3 イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	ID3 データが現在使用可能な MP3 をロードしている Sound オブジェクトです。`target` は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、`currentTarget` プロパティを使用します。

関連項目

Sound.id3

ioError

event

イベントオブジェクトの型: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR

入出力エラーが発生してロード操作が失敗したときに送出されます。

ioError イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	入出力エラーが発生したネットワークオブジェクトです。
`text`	エラーメッセージとして表示されるテキストです。

関連項目

Sound.load()

open

event

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.OPEN

ロード操作が開始したときに送出されます。

open イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	接続をオープンしたネットワークオブジェクトです。

関連項目

Sound.load()

progress

event

イベントオブジェクトの型: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.PROGRESS

ロード処理を実行中にデータを受信したときに送出されます。

progress イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`bytesLoaded`	リスナーがイベントを処理しているときにロードされたアイテム数またはバイト数です。
`bytesTotal`	ロードプロセスが成功した場合に最終的にロードされるアイテムまたはバイトの総数です。
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	進行状況をレポートするネットワークオブジェクトです。

関連項目

Sound.load()

現在のページ: http://livedocs.adobe.com/flex/201_jp/langref/flash/media/Sound.html

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

パッケージ	flash.media
	public class Sound
継承	Sound EventDispatcher Object
Subclasses	SoundAsset