});\r
\r
/**\r
- * <p>複数のバックエンドから、与えられた音声を再生可能なものを見つけ、音声を再生します。\r
+ * <p>è¤\87æ\95°ã\81®ã\82ªã\83¼ã\83\87ã\82£ã\82ªã\83»ã\83\90ã\83\83ã\82¯ã\82¨ã\83³ã\83\89ã\81\8bã\82\89ã\80\81ä¸\8eã\81\88ã\82\89ã\82\8cã\81\9fé\9f³å£°ã\82\92å\86\8dç\94\9få\8f¯è\83½ã\81ªã\82\82ã\81®ã\82\92è¦\8bã\81¤ã\81\91ã\80\81é\9f³å£°ã\82\92å\86\8dç\94\9fã\81\97ã\81¾ã\81\99ã\80\82\r
* <p>HTMLAudio の動作・機能がブラウザ毎にバラバラなのに業を煮やし、メソッドやイベントは独自に定義しています。\r
* <h4>バックエンドの種類</h4>\r
* <p>HTMLAudio, WebAudio, Silverlight, WMP\r
* <h4>イベント</h4>\r
* <dl>\r
- * <dt>X.Event.BACKEND_READY <dd>音声(src リスト)を再生可能なバックエンドが見つかった。\r
- * <dt>X.Event.BACKEND_NONE <dd>音声を再生可能なバックエンドが見つからなかった。Audio は kill されます。\r
- * <dt>X.Event.READY <dd>再生可能、実際の状態は canplay から loadeddata まで様々、、、\r
- * <dt>X.Event.ERROR <dd><ul>\r
+ * <dt>X.Event.BACKEND_READY <dd>音声(src リスト)を再生可能なバックエンドが見つかった。\r
+ * <dt>X.Event.BACKEND_NONE <dd>音声を再生可能なバックエンドが見つからなかった。Audio は kill されます。\r
+ * <dt>X.Event.MEDIA_CAN_TOUCH <dd>モバイル端末の制約で音声の再生またはロードに、タッチを必要とする場合、タッチイベント内で play を呼び出す準備が出来たことを通知する。\r
+ * <dt>X.Event.READY <dd>再生可能、実際の状態は canplay から loadeddata まで様々、、、モバイル端末の場合、タッチして再生が開始された場合に\r
+ * <dt>X.Event.ERROR <dd><ul>\r
* <li> 1 : ユーザーによってメディアの取得が中断された\r
* <li> 2 : ネットワークエラー\r
* <li> 3 : メディアのデコードエラー\r
* <dt>X.Event.MEDIA_PAUSED <dd>ポーズした\r
* <dt>X.Event.MEDIA_WAITING <dd>再生中に音声が待機状態に。\r
* <dt>X.Event.MEDIA_SEEKING <dd>シーク中に音声が待機状態に。\r
- * <dt>X.Event.MEDIA_CAN_TOUCH <dd>シーク中に音声が待機状態に。\r
* </dl>\r
+ * <h4>ソースリストに与える url 文字列</h4>\r
+ * <p>ハッシュフラグメント以下にデータを書くことで、各オーディオバックエンドが再生可能性の判断にあたって参考にするデータを渡すことができます。\r
+ * <dl>\r
+ * <dt>CBR=1<dd>audio が固定ビットレートであることを示す。Android 用 Opera12- は可変ビットレートの mp3 を正しくシークできない。\r
+ * [ 'snd.mp3', 'snd.mp3#CBR=1' ] と指定すると、Android 用 Opera12- では CBR な mp3 が、他の環境ではよりファイルサイズの小さい VBR な mp3 が使用される。(未実装)\r
+ * <dt>ext=mp3<dd>パスに拡張子が含まれない場合、または上書き指定したい場合に指定する\r
* \r
* @alias X.Audio\r
* @class 各種オーディオ機能をラップしインターフェイスを共通化する。\r
* @param {array|string} sourceList\r
* @param {object=} opt_option\r
* @example //\r
- * var audio = X.Audio( [ 'etc/special.mp3', 'etc/special.ogg', 'etc/special.wav' ] )\r
- .listenOnce( X.Event.READY, onReady );\r
+ * var audio = X.Audio( [ 'etc/special.mp3', 'etc/special.ogg', 'etc/special.wav' ] ).listenOnce( X.Event.READY, onReady );\r
*/\r
X[ 'Audio' ] = X_EventDispatcher[ 'inherits' ](\r
'X.Audio',\r
- X_Class.POOL_OBJECT,\r
+ X_Class.NONE,\r
{\r
/**\r
* 音声の url。X.Event.BACKEND_READY で設定される。\r
* @type {string}\r
*/\r
'source' : '',\r
+ \r
/**\r
* 音声再生バックエンドの名前。X.Event.BACKEND_READY で設定される。\r
* @alias Audio.prototype.backendName\r
* @type {string}\r
*/\r
'backendName' : '',\r
- \r
- // TODO\r
+\r
'Constructor' : function( sourceList, opt_option ){\r
X_Audio_startDetectionBackend(\r
X_Audio_BACKENDS[ 0 ], this,\r
/**\r
* 再生。開始位置・終了位置、ループの有無、ループ以降の開始位置、ループ以降の終了位置\r
* @alias Audio.prototype.play\r
+ * @param {number=} startTime 開始時間を ms で\r
+ * @param {number=} endTime 終了時間を ms で\r
+ * @param {boolean=} loop endTimeに達した際に曲をループさせるか\r
+ * @param {number=} loopStartTime ループ以後の開始時間を ms で\r
+ * @param {number=} loopEndTime ループ以後の終了時間を ms で\r
+ * @return {Audio} メソッドチェーン\r
*/\r
'play' : function( startTime, endTime, loop, loopStartTime, loopEndTime ){\r
var pair = X_Pair_get( this );\r
return this;\r
},\r
/**\r
- * シーク\r
+ * シーク、再生中で無い場合は次回再生開始位置の指定のみ\r
* @alias Audio.prototype.seek\r
+ * @param {number} seekTime シーク位置を ms で\r
+ * @return {Audio} メソッドチェーン\r
*/\r
'seek' : function( seekTime ){\r
var pair = X_Pair_get( this );\r
/**\r
* ポーズ\r
* @alias Audio.prototype.pause\r
+ * @return {Audio} メソッドチェーン\r
*/\r
'pause' : function(){\r
var pair = X_Pair_get( this );\r
/**\r
* 状態の getter と setter\r
* @alias Audio.prototype.state\r
+ * @param {object=} obj setter の場合、上書きする値を格納したobject\r
+ * @return {Audio|object}\r
+ * @example\r
+audio.setState(\r
+ {\r
+ 'startTime' : 0,\r
+ 'endTime' : 80000,\r
+ 'loopStartTime' : 120000,\r
+ 'loopEndTime' : 200000,\r
+ 'currentTime' : 0,\r
+ 'loop' : true,\r
+ 'looded' : false,\r
+ 'volume' : 1,\r
+ 'autoplay' : true\r
+});\r
*/\r
'state' : function( obj ){\r
var pair = X_Pair_get( this );\r
'currentTime' : -1,\r
'loop' : false,\r
'looded' : false,\r
- 'error' : false,\r
+ 'error' : 0,\r
+ 'autoplay' : false,\r
'playing' : false,\r
- 'source' : this[ 'source' ] || '',\r
- 'duration' : 0\r
+ 'source' : this[ 'source' ],\r
+ 'duration' : 0,\r
+ 'volume' : 0.5\r
};\r
};\r
pair && pair.setState( obj );\r
return this;\r
}, \r
/**\r
- * ループの getter と setter\r
+ * ループの setter\r
* @alias Audio.prototype.loop\r
+ * @param {boolean} v \r
+ * @return {Audio}\r
*/\r
'loop' : function( v ){\r
var pair = X_Pair_get( this );\r
return this;\r
},\r
/**\r
- * ボリュームの getter と setter 実装不十分！\r
+ * ボリュームの setter 実装不十分！\r
* @alias Audio.prototype.volume\r
+ * @param {number} v 0～1\r
+ * @return {Audio}\r
*/\r
'volume' : function( v ){\r
var pair = X_Pair_get( this );\r
return this;\r
},\r
/**\r
- * 再生位置。\r
+ * å\86\8dç\94\9fä½\8dç½®ã\81®setterã\80\82\r
* @alias Audio.prototype.currentTime\r
+ * @param {number} v msで\r
+ * @return {Audio}\r
*/\r
'currentTime' : function( v ){\r
var pair = X_Pair_get( this );\r
/**\r
* 再生中か？\r
* @alias Audio.prototype.isPlaying\r
+ * @return {boolean}\r
*/\r
'isPlaying' : function(){\r
var pair = X_Pair_get( this );\r
);\r
\r
function X_Audio_handleEvent( e ){\r
- var backend, pair;\r
+ var backend, src, pair;\r
\r
switch( e.type ){\r
case X_EVENT_BACKEND_READY :\r
*/\r
\r
function X_Audio_startDetectionBackend( backend, xaudio, sourceList, option ){\r
- var source = sourceList[ 0 ] || '', \r
- ext = X_URL_getEXT( source ),\r
+ var source = sourceList[ 0 ] || '',\r
+ hash = X_URL_paramToObj( X_URL_getHash( source ) ),\r
+ ext = hash[ 'ext' ] || X_URL_getEXT( source ),\r
sup;\r
\r
if( source && backend ){\r
sup[ 5 ] = sup;\r
\r
xaudio[ 'listenOnce' ]( X_EVENT_COMPLETE, backend, X_Audio_onEndedDetection, sup );\r
- backend.detect( xaudio, source, ext );\r
+ backend.detect( xaudio, ext, hash );\r
} else {\r
xaudio[ 'asyncDispatch' ]( X_EVENT_BACKEND_NONE );\r
};\r
};\r
\r
function X_Audio_onEndedDetection( e, xaudio, sourceList, option, source, ext, sup ){\r
- var i = X_Audio_BACKENDS.indexOf( this ), backend;\r
+ var i = X_Audio_BACKENDS.indexOf( this ), _e, hash, backend;\r
\r
if( e.canPlay ){\r
- xaudio[ 'asyncDispatch' ]( {\r
+ _e = {\r
type : X_EVENT_BACKEND_READY,\r
'option' : option,\r
'source' : source,\r
- 'backendName' : this[ 'backendName' ],\r
+ 'backendName' : this.backendName,\r
'backendID' : i\r
- } ); \r
+ };\r
+ // WebAudio\r
+ if( this.backendID === 1 ) _e[ 'needTouchForPlay' ] = X_WebAudio_need1stTouch;\r
+ // HTMLAudio\r
+ if( this.backendID === 2 ) _e[ 'needTouchForLoad' ] = X_HTMLAudio_need1stTouch;\r
+\r
+ xaudio[ 'asyncDispatch' ]( _e ); \r
} else {\r
- console.log( 'No ' + source + ' ' + this[ 'backendName' ] );\r
+ console.log( 'No ' + source + ' ' + this.backendName );\r
if( sup[ 3 ] = source = sourceList[ sourceList.indexOf( source ) + 1 ] ){\r
- sup[ 4 ] = ext = X_URL_getEXT( source );\r
+ hash = X_URL_paramToObj( X_URL_getHash( source ) );\r
+ sup[ 4 ] = ext = hash[ 'ext' ] || X_URL_getEXT( source );\r
xaudio[ 'listenOnce' ]( X_EVENT_COMPLETE, this, X_Audio_onEndedDetection, sup );\r
- this.detect( xaudio, source, ext );\r
+ this.detect( xaudio, ext, hash );\r
} else\r
if( backend = X_Audio_BACKENDS[ i + 1 ] ){\r
X_Audio_startDetectionBackend( backend, xaudio, sourceList, option );\r
'volume' : this.gain,\r
'playing' : this.playing, \r
'duration' : this.duration,\r
+ 'autoplay' : this.autoplay,\r
\r
'currentTime' : this.playing ? this.getActualCurrentTime() : this.seekTime,\r
'error' : this.getActualError ? this.getActualError() : this.error\r
OSDN Git Service
