Version 0.6.217, add #switch for X.Audio.

[pettanr/clientJs.git] / 0.6.x / js / 07_audio / 00_XAudio.js

diff --git a/0.6.x/js/07_audio/00_XAudio.js b/0.6.x/js/07_audio/00_XAudio.js
index 4b48359..4664aa0 100644 (file)
--- a/0.6.x/js/07_audio/00_XAudio.js
+++ b/0.6.x/js/07_audio/00_XAudio.js
@@ -34,7 +34,7 @@ X_TEMP.onSystemReady.push(
  * <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
@@ -49,6 +49,12 @@ X_TEMP.onSystemReady.push(
  * <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
@@ -211,7 +217,7 @@ audio.setState(
 );\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
@@ -252,8 +258,9 @@ function X_Audio_handleEvent( e ){
  */\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
@@ -261,29 +268,36 @@ function X_Audio_startDetectionBackend( backend, xaudio, sourceList, option ){
                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