* <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.READY <dd>再生可能、実際の状態は canplay から loadeddata まで様々、、、モバイル端末の場合、タッチして再生が開始された場合に\r
* <dt>X.Event.ERROR <dd><ul>\r
* <li> 1 : ユーザーによってメディアの取得が中断された\r
* <li> 2 : ネットワークエラー\r
* <dt>X.Event.MEDIA_WAITING <dd>再生中に音声が待機状態に。\r
* <dt>X.Event.MEDIA_SEEKING <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
* @alias Audio.prototype.play\r
* @param {number=} startTime 開始時間を ms で\r
* @param {number=} endTime 終了時間を ms で\r
- * @param {boolean=} endTime に達した際に曲をループさせるか\r
+ * @param {boolean=} loop endTimeに達した際に曲をループさせるか\r
* @param {number=} loopStartTime ループ以後の開始時間を ms で\r
* @param {number=} loopEndTime ループ以後の終了時間を ms で\r
* @return {Audio} メソッドチェーン\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
+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
/**\r
* ボリュームの setter 実装不十分!\r
* @alias Audio.prototype.volume\r
- * @param {number} v \r
+ * @param {number} v 0~1\r
* @return {Audio}\r
*/\r
'volume' : function( v ){\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