公用屬性:
bytesLoaded:uint(16位無符號整數(shù))
[只讀]返回當(dāng)前聲音對象的可用字節(jié)數(shù)

bytesTotal:int
[只讀]返回聲音對象的總字節(jié)數(shù)

id3:id3信息
[只讀]為讀取mp3文件中的metadata提供訪問方法

isBuffering:布爾
[只讀]返回外部mp3文件的緩沖狀態(tài)

length:number(數(shù)值)
[只讀]以微秒表示的當(dāng)前聲音長度

url:String(字符串)
[只讀]讀取的聲音來源

公用方法:
Sound(stream:URLRequest = null, context:SoundLoaderContext = null)
創(chuàng)建一個(gè)新的Sound對象.

close():void
關(guān)閉音頻流,會導(dǎo)致所有的下載數(shù)據(jù)的丟棄.

load(stream:URLRequest, context:SoundLoaderContext = null):void
初始化外部mp3文件的加載.

play(startTime:Number = 0, loops:int = 0, sndTransform:SoundTransform = null):SoundChannel
生成一個(gè)新的SoundChannel對象來進(jìn)行回放.

Events事件:
complete 當(dāng)數(shù)據(jù)成功加載時(shí)被發(fā)送.
id3 ?? ?? ?? 當(dāng)MP3聲音的ID3數(shù)據(jù)可用時(shí)被發(fā)送.
ioError ?? 當(dāng)輸入輸出錯(cuò)誤導(dǎo)致加載失敗時(shí)被發(fā)送.
open ?? ?? 當(dāng)加載操作開始時(shí)被發(fā)送.
progress 當(dāng)加載操作正在進(jìn)行且受到數(shù)據(jù)時(shí)被發(fā)送.

屬性細(xì)節(jié):
bytesLoaded 屬性

bytesLoaded:uint?? [只讀]
返回當(dāng)前聲音對象的可用字節(jié)數(shù).常常只用于外部加載.

Implementation (實(shí)現(xiàn))
public function get bytesLoaded():uint


bytesTotal 屬性

bytesTotal:int?? [只讀]
返回當(dāng)前聲音對象的總字節(jié)數(shù).

Implementation (實(shí)現(xiàn))
public function get bytesTotal():int

id3 屬性

id3:ID3Info?? [只讀]
提供訪問mp3文件元數(shù)據(jù)的方法.

Mp3聲音文件可包含ID3標(biāo)簽,ID3標(biāo)簽提供文件的元數(shù)據(jù).如果一個(gè)你使用Sound.load()方法加載的mp3文件包含了ID3標(biāo)簽,你可以查詢這些屬性.只有使用UTF-8編碼的ID3標(biāo)簽?zāi)軌虮恢С?
Flash Player 9以及后續(xù)版本支持ID3 2.0標(biāo)簽,特別是2.3和2.4.下面的表格列出了標(biāo)準(zhǔn)的ID3 2.0標(biāo)簽與表示標(biāo)簽內(nèi)容的格式.Sound.id3屬性提供了讀取這些標(biāo)簽的格式,如 my_sound.id3.COMM,my_sound.id3.TIME等等.第一個(gè)表中描述的標(biāo)簽?zāi)軌蛲ㄟ^ID3 2.0的屬性名和動作腳本的屬性名來訪問.第二張表中描述的ID3標(biāo)簽雖然被支持但在動作腳本中沒有預(yù)先定義

ID3 2.0標(biāo)簽 ?? ?? ?? ?? ?? ?? ?? 對應(yīng)的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


下面的表中描述的ID3標(biāo)簽在動作腳本中沒有預(yù)先定義.您可以通過下面的方式訪問它們,例如mySound.id3.TFLT, mySound.id3.TIME等等.

屬性 ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ??? 描述
TFLT ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 文件類型
TIME ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 時(shí)間
TIT1 ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 包含群組描述
TIT2 ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 標(biāo)題/歌曲名/描述
TIT3 ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 子標(biāo)題/詳細(xì)說明
TKEY ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ??? 起始地址
TLAN ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ??? 語言
TLEN ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ??? 長度
TMED ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ??? 媒體類型
TOAL ?? ?? ?? ?? ?? ?? ?? ?? ?? 原專輯/電影/顯示標(biāo)題
TOFN ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 原文件名
TOLY ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 作詞作曲
TOPE ?? ?? ?? ?? ?? ?? ?? ?? ?? 藝術(shù)家/表演者
TORY ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 發(fā)行年
TOWN ?? ?? ?? ?? ?? ?? ?? ?? 文件所有者/許可
TPE1 ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 主要表演者/主唱
TPE2 ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 樂隊(duì)/伴奏
TPE3 ?? ?? ?? ?? ?? ?? ?? ?? Conductor/performer refinement
TPE4 ?? ?? ?? ?? ?? ?? ?? ?? ?? 合聲,混音,或其他制作人
TPOS ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? Part of a set
TPUB ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 出版發(fā)行
TRCK ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 音軌號/曲目號
TRDA ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 錄制日期
TRSN ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 網(wǎng)絡(luò)發(fā)射臺名稱
TRSO ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 網(wǎng)絡(luò)發(fā)射臺所有人
TSIZ ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 尺寸
TSRC ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ISRC 國際標(biāo)準(zhǔn)記錄編碼(international standard recording code)
TSSE ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 軟/硬編碼及設(shè)置
TYER ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ??? 年份
WXXX ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 鏈接頁面


又是網(wǎng)絡(luò)沙箱,這段略過

PS:突然發(fā)現(xiàn)藍(lán)色理想有id3v2的信息,比我這好多了
貼在這里

isBuffering 屬性

isBuffering:Boolean?? [只讀]
返回外部mp3文件的緩沖狀態(tài).如果值為真,則當(dāng)對象等待數(shù)據(jù)時(shí)回放將會掛起.

Implementation(實(shí)現(xiàn))
public function get isBuffering():Boolean


length 屬性

length:Number?? [只讀]
以微秒表示的當(dāng)前聲音長度.

Implementation 實(shí)現(xiàn)
public function get length():Number


url 屬性

url:String?? [只讀]
所加載的聲音的地址.該屬性只對用Sound.load()方式加載的Sound對象有效.對于關(guān)聯(lián)到swf庫中聲音資源的Sound對象url屬性的返回值為null.

當(dāng)你第一次調(diào)用Sound.load()函數(shù),url屬性將會賦值為null,因?yàn)樽罱K的url還不確定.當(dāng)Sound對象中傳出open事件的同時(shí),url屬性會立即變?yōu)榉强罩?

url屬性包含了加載的聲音的最終的絕對的地址.通常情況下,url的值與傳給Sound.load()的參數(shù)值一致.不過,如果你將相對的地址作為參數(shù) 傳給Sound.load(),那么url屬性值將會返回出絕對的地址. 另外,如果原來的地址請求被http服務(wù)器重定向,那么url屬性值反映的是聲音文件所在的真實(shí)地址.這個(gè)最終絕對的地址的報(bào)告與等價(jià)于 LoaderInfo.url的行為.

Implementation 實(shí)現(xiàn)
public function get url():String

構(gòu)造函數(shù) 詳細(xì)
Sound () 函數(shù)

public function Sound(stream:URLRequest = null, context:SoundLoaderContext = null)
創(chuàng)建一個(gè)新的Sound對象.如果你將一個(gè)有效的URLRequest對象傳遞給Sound函數(shù),函數(shù)將自動調(diào)用Sound對象的load()函數(shù).如果 你沒有將有效的URLRequest對象傳遞給Sound構(gòu)造函數(shù),你必須親自調(diào)用load()函數(shù),否則,音頻流將不會被加載.

一旦Sound對象中的load()被調(diào)用,您不能再向該Sound對象加載另一個(gè)聲音文件.若要載入另一個(gè)不同的聲音文件,請創(chuàng)建一個(gè)新的Sound對象.

參數(shù)?? stream:URLRequest (default = null) — 這個(gè)地址指向外部的mp3文件.??
??
相關(guān)內(nèi)容:SoundLoaderContext (default = null) — Minimum number of milliseconds of MP3 data to hold in the Sound object's buffer. The Sound object waits until it has at least this much data before beginning playback and before resuming playback after a network stall. The default value is 1000 (one second).??

方法 細(xì)節(jié)
close () 方法

public function close():void
關(guān)閉音頻流,會導(dǎo)致所有的下載數(shù)據(jù)的終結(jié).調(diào)用close()方法之后將不能從音頻流中讀取數(shù)據(jù).


出現(xiàn)?? IOError — 流無法被關(guān)閉或打開.??

load () 方法

public function load(stream:URLRequest, context:SoundLoaderContext = null):void
初始化從指定地址對外部mp3文件的加載.如果你將一個(gè)有效的URLRequest對象傳遞給Sound函數(shù),函數(shù)將自動調(diào)用Sound對象的 load()函數(shù).在你沒有將有效的URLRequest對象傳遞給Sound構(gòu)造函數(shù)時(shí),你需要親自調(diào)用load()函數(shù).

一旦Sound對象中的load()被調(diào)用,您不能再向該Sound對象加載另一個(gè)聲音文件.若要載入另一個(gè)不同的聲音文件,請創(chuàng)建一個(gè)新的Sound對象.

沙箱又來了......

參數(shù)?? stream:URLRequest — A URL that points to an external MP3 file.??
??
有關(guān)內(nèi)容:SoundLoaderContext (default = null) — Minimum number of milliseconds of MP3 data to hold in the Sound object's buffer. The Sound object waits until it has at least this much data before beginning playback and before resuming playback after a network stall. The default value is 1000 (one second).??

發(fā)生?? IOError — 網(wǎng)絡(luò)錯(cuò)誤導(dǎo)致加載失敗.??
??
安全錯(cuò)誤SecurityError — 本地的不受信的swf文件無法訪問internet.您可以將其重新分類為本地對網(wǎng)絡(luò)或者將其加入信任列表.??

play () 方法

public function play(startTime:Number = 0, loops:int = 0, sndTransform:SoundTransform = null):SoundChannel
生成一個(gè)新的SoundChannel對象來進(jìn)行回放.此方法返回一個(gè)SoundChannel對象,您可以通過這個(gè)SoundChannel對象來停止 播放聲音和調(diào)整音量. (要控制音量,偏移,平衡,通過分配給sound channel的SoundTransform對象來訪問.)

參數(shù)
?? startTime:Number (default = 0) — 用微秒表示的回放開始位置.??
??
loops:int (default = 0) — 定義在sound channel停止回放前聲音循環(huán)播放的次數(shù).??
??
sndTransform:SoundTransform (default = null) — 分配給聲道的SoundTransform對象.??


返回值
?? SoundChannel — 一個(gè)你用來控制聲音的SoundChannel對象.如果你沒有聲卡或者你已經(jīng)沒有可用的聲音通道,這個(gè)方法將返回空值null.聲音通道的一次性最大可用數(shù)是32.

事件細(xì)節(jié)
complete 事件
事件對象類型:flash.events.Event
Event類屬性=flash.events.Event.COMPLETE

當(dāng)數(shù)據(jù)成功加載時(shí)觸發(fā).
完成事件對象的屬性值

該事件有如下屬性:
屬性名稱 ?? ?? ?? ?? ?? ?? ?? 屬性值
bubbles ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? false
cancelable ?? ?? ?? ?? ?? ?? ?? ?? ??? false;默認(rèn)沒有取消
currentTarget ?? ?? ?? ?? ?? ?? ??? 當(dāng)前使用監(jiān)聽器檢測該事件對象的影片對象
target ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 已經(jīng)完成下載工作的網(wǎng)絡(luò)對象.target并不總是
?? ?? ?? ?? ?? ?? ?? ?? 存在于注冊了偵聽器的顯示列表中.使用currentTarget屬性
?? ?? ?? ?? ?? ?? ?? ?? 來獲取操作當(dāng)前事件的對象.

參考Sound.load()

id3 事件
事件對象類型:flash.events.Event
Event類 屬性值=flash.events.Event.ID3

當(dāng)mp3聲音對象的ID3數(shù)據(jù)可用時(shí)被觸發(fā).
該事件有如下屬性:
屬性名稱 ?? ?? ?? ?? ?? ?? ?? 屬性值
bubbles ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? false
cancelable ?? ?? ?? ?? ?? ?? ?? ?? ??? false;默認(rèn)沒有取消
currentTarget ?? ?? ?? ?? ?? ?? ??? 當(dāng)前使用監(jiān)聽器檢測該事件對象的影片對象
target ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 已經(jīng)完成下載工作的網(wǎng)絡(luò)對象.target并不總是
?? ?? ?? ?? ?? ?? ?? ?? 存在于注冊了偵聽器的顯示列表中.使用currentTarget屬性
?? ?? ?? ?? ?? ?? ?? ?? 來獲取操作當(dāng)前事件的對象.

昏...和complete完全一樣

參看:Sound.id3

ioError事件
事件對象屬性:flash.events.IOErrorEvent
IORrrorEvent類 屬性值=flash.events.IOErrorEvent.IO_ERROR
當(dāng)輸入輸出錯(cuò)誤導(dǎo)致加載操作失敗時(shí)被觸發(fā).

該事件有如下屬性:
屬性名稱 ?? ?? ?? ?? ?? ?? ?? 屬性值
bubbles ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? false
cancelable ?? ?? ?? ?? ?? ?? ?? ?? ??? false;默認(rèn)沒有取消
currentTarget ?? ?? ?? ?? ?? ?? ??? 當(dāng)前使用監(jiān)聽器檢測該事件對象的影片對象
target ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 發(fā)生輸入輸出錯(cuò)誤的網(wǎng)絡(luò)對象
text ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 作為錯(cuò)誤信息輸出的文字信息

參看
Sound.load()

open事件
事件對象類型:flash.events.Event
Event類 屬性值=flash.events.Event.OPEN

當(dāng)加載操作開始時(shí)被觸發(fā).
該事件有如下屬性:
屬性名稱 ?? ?? ?? ?? ?? ?? ?? 屬性值
bubbles ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? false
cancelable ?? ?? ?? ?? ?? ?? ?? ?? ??? false;默認(rèn)沒有取消
currentTarget ?? ?? ?? ?? ?? ?? ??? 當(dāng)前使用監(jiān)聽器檢測該事件對象的影片對象
target ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ??? 開始連接的網(wǎng)絡(luò)對象

又參看
Sound.load()

progress事件
事件對象類型:flash.events.ProgressEvent
ProgressEvent類 屬性值=flash.events.ProgressEvent.PROGRESS

當(dāng)加載操作運(yùn)作中收到數(shù)據(jù)時(shí)被觸發(fā)

該事件有如下屬性:

屬性名稱 ?? ?? ?? ?? ?? ?? ?? 屬性值
bubbles ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? false
bytesloaded ?? ?? ?? ?? ?? ?? 偵聽器檢測到事件時(shí)所加載的條目個(gè)數(shù)或者比特?cái)?shù)
bytestotal ?? ?? ?? ?? ?? ?? ?? 當(dāng)加載進(jìn)程成功完成時(shí)預(yù)計(jì)加載的總數(shù)或者總比特?cái)?shù)
cancelable ?? ?? ?? ?? ?? ?? ?? ?? ??? false;默認(rèn)沒有取消
currentTarget ?? ?? ?? ?? ?? ?? ??? 當(dāng)前使用監(jiān)聽器檢測該事件對象的影片對象
target ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 報(bào)告正在工作中的網(wǎng)絡(luò)對象

參看
Sound.load()

例子:
下面的例子將向您展示發(fā)生在mp3文件打開與播放時(shí)的聲音事件及其信息.要運(yùn)行這個(gè)例子,在與您的swf文件相同目錄下放置一個(gè)名字為"Mysound.mp3"的文件.
package {
import flash.display.Sprite;
import flash.events.*;
import flash.media.Sound;
import flash.media.SoundChannel;
import flash.net.URLRequest;

public class SoundExample extends Sprite {
?? ??? private var url:String = "MySound.mp3";
?? ??? private var song:SoundChannel;

?? ??? public function SoundExample() {
?? ?? ?? var request:URLRequest = new URLRequest(url);
?? ?? ?? var soundFactory:Sound = new Sound();
?? ?? ?? soundFactory.addEventListener(Event.COMPLETE, completeHandler);
?? ?? ?? soundFactory.addEventListener(Event.ID3, id3Handler);
?? ?? ?? soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
?? ?? ?? soundFactory.addEventListener(ProgressEvent.PROGRESS, progressHandler);
?? ?? ?? soundFactory.load(request);
?? ?? ?? song = soundFactory.play();
?? ??? }

?? ??? private function completeHandler(event:Event):void {
?? ?? ?? trace("completeHandler: " + event);
?? ??? }

?? ??? private function id3Handler(event:Event):void {
?? ?? ?? trace("id3Handler: " + event);
?? ??? }

?? ??? private function ioErrorHandler(event:Event):void {
?? ?? ?? trace("ioErrorHandler: " + event);
?? ??? }

?? ??? private function progressHandler(event:ProgressEvent):void {
?? ?? ?? trace("progressHandler: " + event);
?? ??? }
}
}

peterd_mm 于2006年七月25日下午8點(diǎn)25分留言:
bytesTotal屬性,在總比特?cái)?shù)無法確定的情況下返回零值.(比如,下載初始化時(shí),服務(wù)器沒有傳送HTTP頭)
The bytesTotal property, returns 0 if the number of total bytes can't be determined (for example, if the download was initiated but the server did not transmit an HTTP content-length).

Peter
Flash Player documentation
Adobe Systems Incorporated

完成!!