OSDN Git Service

Version 0.6.178, fix X.KB for IE5-, X.HTMLAudio for ChromeWV & AOSP.
[pettanr/clientJs.git] / 0.6.x / js / 07_audio / 00_XAudio.js
index e923109..4de81ae 100644 (file)
@@ -1,7 +1,7 @@
 \r
 /*\r
        WebAudio    : 1,\r
-       HTML5       : 2,\r
+       HTMLAudio   : 2,\r
        Flash       : 3,\r
        Silverlight : 4,\r
        Unity       : 5,\r
 \r
 var X_Audio_BACKENDS     = []; // Array.<Hash>\r
 \r
-/*\r
- * X_EVENT_BACKEND_READY\r
- * X_EVENT_BACKEND_NONE\r
- * \r
- * X_EVENT_READY   再生可能、実際の状態は canplay から loadeddata まで様々、、、\r
- * X_EVENT_ERROR\r
- *   1 : ユーザーによってメディアの取得が中断された\r
- *   2 : ネットワークエラー\r
- *   3 : メディアのデコードエラー\r
- *   4 : メディアがサポートされていない\r
+X_TEMP.onSystemReady.push(\r
+       function(){\r
+               var canPlay = X[ 'Audio' ][ 'canPlay' ] = {},\r
+                       i = X_Audio_BACKENDS.length,\r
+                       be;\r
+               for( ; i; ){\r
+                       be = X_Audio_BACKENDS[ --i ];\r
+                       X_Object_override( canPlay, be.canPlay );\r
+                       X[ 'Audio' ][ be.backendName ] = be.backendID;\r
+               };\r
+       });\r
+\r
+/**\r
+ * <p>複数のバックエンドから、与えられた音声を再生可能なものを見つけ、音声を再生します。\r
+ * <p>HTMLAudio の動作・機能がブラウザ毎にバラバラなのに業を煮やし、メソッドやイベントは独自に定義しています。\r
+ * <h4>バックエンドの種類</h4>\r
+ * <p>HTMLAudio, WebAudio, Silverlight\r
+ * <h4>イベント</h4>\r
+ * <dl>\r
+ * <dt>X.Event.BACKEND_READY <dd>音声(src リスト)を再生可能なバックエンドが見つかった。\r
+ * <dt>X.Event.BACKEND_NONE  <dd>音声を再生可能なバックエンドが見つからなかった。\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
+ *   <li> 4 : メディアがサポートされていない\r
+ * </ul>\r
+ * <dt>X.Event.MEDIA_PLAYING <dd>再生中に1秒以下のタイミングで発生.currentTime が取れる?\r
+ * <dt>X.Event.MEDIA_LOOP    <dd>ループ直前に発生、キャンセル可能\r
+ * <dt>X.Event.MEDIA_LOOPED  <dd>ループ時に発生\r
+ * <dt>X.Event.MEDIA_ENDED   <dd>再生位置の(音声の)最後についた\r
+ * <dt>X.Event.MEDIA_PAUSED  <dd>ポーズした\r
+ * <dt>X.Event.MEDIA_WAITING <dd>再生中に音声が待機状態に。\r
+ * <dt>X.Event.MEDIA_SEEKING <dd>シーク中に音声が待機状態に。\r
+ * </dl>\r
  * \r
- * X_EVENT_MEDIA_PLAYING 再生中に1秒以下のタイミングで発生.currentTime が取れる?\r
- * X_EVENT_MEDIA_LOOP    ループ直前に発生、キャンセル可能\r
- * X_EVENT_MEDIA_LOOPED  ループ時に発生\r
- * X_EVENT_MEDIA_ENDED   再生位置の(音声の)最後についた\r
- * X_EVENT_MEDIA_PAUSED  ポーズした\r
- * X_EVENT_MEDIA_WAITING 再生中に音声が待機状態に。間もなく X_EVENT_MEDIA_PLAYING に移行。\r
- * X_EVENT_MEDIA_SEEKING シーク中に音声が待機状態に。間もなく X_EVENT_MEDIA_PLAYING に移行。\r
+ * @alias X.Audio\r
+ * @class 各種オーディオ機能をラップしインターフェイスを共通化する。\r
+ * @constructs Audio\r
+ * @extends {EventDispatcher}\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
  */\r
-\r
-// TODO この内容は、AudioBackend の Abstract クラスにする。AudioSprite は Audio ではなく AudioBackend をマネージする\r
 X[ 'Audio' ] = X_EventDispatcher[ 'inherits' ](\r
        'X.Audio',\r
        X_Class.POOL_OBJECT,\r
        {\r
+               /**\r
+                * 音声の url。X.Event.BACKEND_READY で設定される。\r
+                * @alias Audio.prototype.source\r
+                * @type {string}\r
+                */\r
                'source'      : '',\r
+               /**\r
+                * 音声再生バックエンドの名前。X.Event.BACKEND_READY で設定される。\r
+                * @alias Audio.prototype.backendName\r
+                * @type {string}\r
+                */\r
                'backendName' : '',\r
                \r
                'Constructor' : function( sourceList, opt_option ){\r
                        X_Audio_startDetectionBackend(\r
                                X_Audio_BACKENDS[ 0 ], this,\r
-                               X_Type_isArray( sourceList ) ? X_Object_cloneArray( sourceList ) : [ sourceList ],\r
+                               X_Type_isArray( sourceList ) ? X_Array_copy( sourceList ) : [ sourceList ],\r
                                opt_option || {} );\r
                        this[ 'listenOnce' ]( [ X_EVENT_BACKEND_READY, X_EVENT_BACKEND_NONE, X_EVENT_KILL_INSTANCE ], X_Audio_handleEvent );\r
                },\r
                \r
+               /**\r
+                * 再生。開始位置・終了位置、ループの有無、ループ以降の開始位置、ループ以降の終了位置\r
+                * @alias Audio.prototype.play\r
+                */\r
                'play' : function( startTime, endTime, loop, loopStartTime, loopEndTime ){\r
                        var pair = X_Pair_get( this );\r
                        pair && pair.play( startTime, endTime, loop, loopStartTime, loopEndTime );\r
                        return this;\r
                },\r
-               \r
+               /**\r
+                * シーク\r
+                * @alias Audio.prototype.seek\r
+                */\r
                'seek' : function( seekTime ){\r
                        var pair = X_Pair_get( this );\r
                        pair && pair.seek( seekTime );\r
                        return this;\r
                },\r
-               \r
+               /**\r
+                * ポーズ\r
+                * @alias Audio.prototype.pause\r
+                */\r
                'pause' : function(){\r
                        var pair = X_Pair_get( this );\r
                        pair && pair.pause();\r
                        return this;\r
                },\r
-               \r
+               /**\r
+                * 状態の getter と setter\r
+                * @alias Audio.prototype.state\r
+                */\r
                'state' : function( obj ){\r
                        var pair = X_Pair_get( this );\r
                        if( obj === undefined ){\r
@@ -87,25 +136,37 @@ X[ 'Audio' ] = X_EventDispatcher[ 'inherits' ](
                        pair && pair.setState( obj );\r
                        return this;\r
                },              \r
-               \r
+               /**\r
+                * ループの getter と setter\r
+                * @alias Audio.prototype.loop\r
+                */\r
                'loop' : function( v ){\r
                        var pair = X_Pair_get( this );\r
                        pair && pair.loop( v );\r
                        return this;\r
                },\r
-\r
+               /**\r
+                * ボリュームの getter と setter 実装不十分!\r
+                * @alias Audio.prototype.volume\r
+                */\r
                'volume' : function( v ){\r
                        var pair = X_Pair_get( this );\r
                        pair && pair.volume( v );\r
                        return this;\r
                },\r
-\r
+               /**\r
+                * 再生位置。\r
+                * @alias Audio.prototype.currentTime\r
+                */\r
                'currentTime' : function( v ){\r
                        var pair = X_Pair_get( this );\r
                        pair && pair.currentTime( v );\r
                        return this;\r
                },\r
-\r
+               /**\r
+                * 再生中か?\r
+                * @alias Audio.prototype.isPlaying\r
+                */\r
                'isPlaying' : function(){\r
                        var pair = X_Pair_get( this );\r
                        return pair && pair.playing;\r
@@ -164,7 +225,6 @@ function X_Audio_onEndedDetection( e, xaudio, sourceList, option, source, ext, s
        var i = X_Audio_BACKENDS.indexOf( this ), backend;\r
        \r
        if( e.canPlay ){\r
-               xaudio._backend = i;\r
                xaudio[ 'asyncDispatch' ]( {\r
                        type          : X_EVENT_BACKEND_READY,\r
                        'option'      : option,\r
@@ -189,71 +249,73 @@ function X_Audio_onEndedDetection( e, xaudio, sourceList, option, source, ext, s
 \r
 \r
 \r
-var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](\r
-       'X.AbstractAudioBackend',\r
+var X_AudioBase = X_EventDispatcher[ 'inherits' ](\r
+       'X.AudioBase',\r
        X_Class.ABSTRACT,\r
        {\r
+               disatcher     : null,\r
                \r
-               url           : '',\r
-               target        : null,\r
-               \r
-               startTime     : 0,\r
-               endTime       : -1,\r
+               startTime     : 0,    //\r
+               endTime       : -1,   //\r
                loopStartTime : -1,\r
                loopEndTime   : -1,\r
                seekTime      : -1,\r
-               duration      : 0,\r
+               duration      : 0,    //\r
 \r
                playing       : false,\r
-               error         : 0,                      \r
+               error         : 0,    //                \r
                autoLoop      : false,\r
                looped        : false,\r
-               autoplay      : false,\r
+               autoplay      : false,//\r
                gain          : 0.5,\r
                \r
                play : function( startTime, endTime, loop, loopStartTime, loopEndTime ){\r
                        if( 0 <= startTime ){\r
                                this.setState( {\r
-                                       currentTime   : startTime,\r
-                                       startTime     : startTime,\r
-                                       endTime       : endTime,\r
-                                       loop          : loop,\r
-                                       loopStartTime : loopStartTime,\r
-                                       loopEndTime   : loopEndTime\r
+                                       'currentTime'   : startTime,\r
+                                       'startTime'     : startTime,\r
+                                       'endTime'       : endTime,\r
+                                       'loop'          : loop,\r
+                                       'looped'        : false,\r
+                                       'loopStartTime' : loopStartTime,\r
+                                       'loopEndTime'   : loopEndTime\r
                                } );\r
                        };\r
+                       // canPlay() : autoplay = true\r
                        this.actualPlay();\r
                },\r
                \r
                seek : function( seekTime ){\r
-                       if( seekTime < X_AudioWrapper_getEndTime( this ) ){\r
-                               this.setState( { currentTime : seekTime } );\r
+                       if( seekTime < X_Audio_getEndTime( this ) ){\r
+                               this.setState( { 'currentTime' : seekTime } );\r
                        };\r
                },\r
                \r
                pause : function(){\r
                        this.playing && this.actualPause();\r
+                       // delete this.autoplay\r
+                       // delete this.playing\r
                },              \r
                \r
                loop : function( v ){\r
                        if( v === undefined ){\r
                                return this.autoLoop;\r
                        };\r
-                       this.setState( { loop : v } );\r
+                       this.setState( { 'loop' : v } );\r
                },\r
 \r
                volume : function( v ){\r
                        if( v === undefined ){\r
                                return this.gain;\r
                        };\r
-                       this.setState( { volume : v } );\r
+                       this.setState( { 'volume' : v } );\r
                },\r
 \r
                currentTime : function( v ){\r
                        if( v === undefined ){\r
                                return this.playing ? this.getActualCurrentTime() : this.seekTime;\r
                        };\r
-                       this.setState( { currentTime : v } );\r
+                       this.setState( { 'currentTime' : v } );\r
                },\r
                \r
                getState : function(){\r
@@ -283,7 +345,7 @@ var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](
                                v = obj[ k ];\r
                                switch( k ){\r
                                        case 'currentTime' :\r
-                                               v = X_AudioWrapper_timeStringToNumber( v );\r
+                                               v = X_Audio_timeStringToNumber( v );\r
                                                if( X_Type_isNumber( v ) ){\r
                                                        if( playing ){\r
                                                                if( this.getActualCurrentTime() !== v ){\r
@@ -299,7 +361,7 @@ var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](
                                                break;\r
                                                        \r
                                        case 'startTime'     :\r
-                                               v = X_AudioWrapper_timeStringToNumber( v );\r
+                                               v = X_Audio_timeStringToNumber( v );\r
                                                if( v || v === 0 ){\r
                                                        if( this.startTime !== v ){\r
                                                                this.startTime = v;                                     \r
@@ -310,7 +372,7 @@ var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](
                                                break;\r
                                        \r
                                        case 'endTime'       :\r
-                                               v = X_AudioWrapper_timeStringToNumber( v );\r
+                                               v = X_Audio_timeStringToNumber( v );\r
                                                if( v || v === 0 ){\r
                                                        if( this.endTime !== v ){\r
                                                                this.endTime = v;\r
@@ -323,7 +385,7 @@ var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](
                                                break;\r
                                                \r
                                        case 'loopStartTime' :\r
-                                               v = X_AudioWrapper_timeStringToNumber( v );\r
+                                               v = X_Audio_timeStringToNumber( v );\r
                                                if( v || v === 0 ){\r
                                                        if( this.loopStartTime !== v ){\r
                                                                this.loopStartTime = v;                                 \r
@@ -334,7 +396,7 @@ var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](
                                                break;\r
                                                \r
                                        case 'loopEndTime'   :\r
-                                               v = X_AudioWrapper_timeStringToNumber( v );\r
+                                               v = X_Audio_timeStringToNumber( v );\r
                                                if( v || v === 0 ){\r
                                                        if( this.loopEndTime !== v ){\r
                                                                this.loopEndTime = v;\r
@@ -375,33 +437,37 @@ var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](
                                                        };\r
                                                };\r
                                                break;\r
+                                       case 'useVideo' :\r
+                                               break;\r
+                                       default :\r
+                                               throw ( 'bad arg! ' + k );\r
                                };\r
                        };\r
                        \r
                        if( this.endTime < this.startTime ||\r
                                ( this.loopEndTime < 0 ? this.endTime : this.loopEndTime ) < ( this.loopStartTime < 0 ? this.startTime : this.loopStartTime ) ||\r
-                               X_AudioWrapper_getEndTime( this ) < this.seekTime// ||\r
+                               X_Audio_getEndTime( this ) < this.seekTime// ||\r
                                //this.duration < this.endTime\r
                        ){\r
-                               console.log( 'setState 0:' + this.startTime + ' -> ' + this.endTime + ' d:' + this.duration + ' 1:' + this.loopStartTime + ' -> ' + this.loopEndTime );\r
+                               console.log( 'setState 0:' + this.startTime + ' -> ' + this.endTime + ' looped:' + this.looped + ' 1:' + this.loopStartTime + ' -> ' + this.loopEndTime );\r
                                return;\r
                        };\r
                        \r
                        v = end + seek + volume;\r
-                       return v && this.afterUpdateState( v );         \r
+                       return v && this.playing && this.afterUpdateState( v );\r
                }\r
                \r
        }\r
 );\r
 \r
 \r
-function X_AudioWrapper_timeStringToNumber( time ){\r
+function X_Audio_timeStringToNumber( time ){\r
        var ary, ms, s = 0, m = 0, h = 0;\r
        if( X_Type_isNumber( time ) ) return time;\r
        if( !X_Type_isString( time ) || !time.length ) return;\r
 \r
        ary = time.split( '.' );\r
-       ms  = parseInt( ( ary[ 1 ] + '000' ).substr( 0, 3 ) ) || 0;\r
+       ms  = parseFloat( ( ary[ 1 ] + '000' ).substr( 0, 3 ) ) || 0;\r
        \r
        ary = ary[ 0 ].split( ':' );\r
        if( 3 < ary.length ) return;\r
@@ -410,17 +476,17 @@ function X_AudioWrapper_timeStringToNumber( time ){
                case 0 :\r
                        break;\r
                case 1 :\r
-                       s = parseInt( ary[ 0 ] ) || 0;\r
+                       s = parseFloat( ary[ 0 ] ) || 0;\r
                        break;\r
                case 2 :\r
-                       m = parseInt( ary[ 0 ] ) || 0;\r
-                       s = parseInt( ary[ 1 ] ) || 0;\r
+                       m = parseFloat( ary[ 0 ] ) || 0;\r
+                       s = parseFloat( ary[ 1 ] ) || 0;\r
                        if( 60 <= s ) alert( 'invalid time string ' + time );\r
                        break;\r
                case 3 :\r
-                       h = parseInt( ary[ 0 ] ) || 0;\r
-                       m = parseInt( ary[ 1 ] ) || 0;\r
-                       s = parseInt( ary[ 2 ] ) || 0;\r
+                       h = parseFloat( ary[ 0 ] ) || 0;\r
+                       m = parseFloat( ary[ 1 ] ) || 0;\r
+                       s = parseFloat( ary[ 2 ] ) || 0;\r
                        if( 60 <= s ) alert( 'invalid time string ' + time );\r
                        if( 60 <= m ) alert( 'invalid time string ' + time );\r
                        break;\r
@@ -431,8 +497,9 @@ function X_AudioWrapper_timeStringToNumber( time ){
        return ms < 0 ? 0 : ms;\r
 };\r
 \r
-function X_AudioWrapper_getStartTime( audioWrapper, endTime, delSeekTime ){\r
+function X_Audio_getStartTime( audioWrapper, endTime, delSeekTime ){\r
        var seek = audioWrapper.seekTime;\r
+       \r
        if( delSeekTime ) delete audioWrapper.seekTime;\r
        \r
        if( 0 <= seek ){\r
@@ -449,7 +516,7 @@ function X_AudioWrapper_getStartTime( audioWrapper, endTime, delSeekTime ){
        return audioWrapper.startTime;\r
 };\r
 \r
-function X_AudioWrapper_getEndTime( audioWrapper ){\r
+function X_Audio_getEndTime( audioWrapper ){\r
        var duration = audioWrapper.duration;\r
        \r
        if( audioWrapper.looped && 0 <= audioWrapper.loopEndTime ){\r