0.6.x/js/07_audio/00_XAudio.js

   1 \r
   2 /*\r
   3         WebAudio    : 1,\r
   4         HTMLAudio   : 2,\r
   5         Flash       : 3,\r
   6         Silverlight : 4,\r
   7         Unity       : 5,\r
   8         WMP         : 6,\r
   9         RealPlayer  : 7,\r
  10         QuickTime   : 8,\r
  11  */\r
  12 \r
  13 var X_Audio_BACKENDS     = []; // Array.<Hash>\r
  14 \r
  15 X_TEMP.onSystemReady.push(\r
  16         function(){\r
  17                 var canPlay = X[ 'Audio' ][ 'canPlay' ] = {},\r
  18                         i = X_Audio_BACKENDS.length,\r
  19                         be;\r
  20                 for( ; i; ){\r
  21                         be = X_Audio_BACKENDS[ --i ];\r
  22                         X_Object_override( canPlay, be.canPlay );\r
  23                         X[ 'Audio' ][ be.backendName ] = be.backendID;\r
  24                 };\r
  25         });\r
  26 \r
  27 /**\r
  28  * <p>複数のバックエンドから、与えられた音声を再生可能なものを見つけ、音声を再生します。\r
  29  * <p>HTMLAudio の動作・機能がブラウザ毎にバラバラなのに業を煮やし、メソッドやイベントは独自に定義しています。\r
  30  * <h4>バックエンドの種類</h4>\r
  31  * <p>HTMLAudio, WebAudio, Silverlight, WMP\r
  32  * <h4>イベント</h4>\r
  33  * <dl>\r
  34  * <dt>X.Event.BACKEND_READY <dd>音声(src リスト)を再生可能なバックエンドが見つかった。\r
  35  * <dt>X.Event.BACKEND_NONE  <dd>音声を再生可能なバックエンドが見つからなかった。Audio は kill されます。\r
  36  * <dt>X.Event.READY         <dd>再生可能、実際の状態は canplay から loadeddata まで様々、、、\r
  37  * <dt>X.Event.ERROR         <dd><ul>\r
  38  *   <li> 1 : ユーザーによってメディアの取得が中断された\r
  39  *   <li> 2 : ネットワークエラー\r
  40  *   <li> 3 : メディアのデコードエラー\r
  41  *   <li> 4 : メディアがサポートされていない\r
  42  * </ul>\r
  43  * <dt>X.Event.MEDIA_PLAYING   <dd>再生中に1秒以下のタイミングで発生．currentTime が取れる?\r
  44  * <dt>X.Event.MEDIA_LOOP      <dd>ループ直前に発生、ｷｬﾝｾﾙ可能\r
  45  * <dt>X.Event.MEDIA_LOOPED    <dd>ループ時に発生\r
  46  * <dt>X.Event.MEDIA_ENDED     <dd>再生位置の(音声の)最後についた\r
  47  * <dt>X.Event.MEDIA_PAUSED    <dd>ポーズした\r
  48  * <dt>X.Event.MEDIA_WAITING   <dd>再生中に音声が待機状態に。\r
  49  * <dt>X.Event.MEDIA_SEEKING   <dd>シーク中に音声が待機状態に。\r
  50  * <dt>X.Event.MEDIA_CAN_TOUCH <dd>シーク中に音声が待機状態に。\r
  51  * </dl>\r
  52  * \r
  53  * @alias X.Audio\r
  54  * @class 各種オーディオ機能をラップしインターフェイスを共通化する。\r
  55  * @constructs Audio\r
  56  * @extends {EventDispatcher}\r
  57  * @param {array|string} sourceList\r
  58  * @param {object=} opt_option\r
  59  * @example //\r
  60  * var audio = X.Audio( [ 'etc/special.mp3', 'etc/special.ogg', 'etc/special.wav' ] )\r
  61                                         .listenOnce( X.Event.READY, onReady );\r
  62  */\r
  63 X[ 'Audio' ] = X_EventDispatcher[ 'inherits' ](\r
  64         'X.Audio',\r
  65         X_Class.POOL_OBJECT,\r
  66         {\r
  67                 /**\r
  68                  * 音声の url。X.Event.BACKEND_READY で設定される。\r
  69                  * @alias Audio.prototype.source\r
  70                  * @type {string}\r
  71                  */\r
  72                 'source'      : '',\r
  73                 /**\r
  74                  * 音声再生バックエンドの名前。X.Event.BACKEND_READY で設定される。\r
  75                  * @alias Audio.prototype.backendName\r
  76                  * @type {string}\r
  77                  */\r
  78                 'backendName' : '',\r
  79                 \r
  80                 // TODO\r
  81                 'Constructor' : function( sourceList, opt_option ){\r
  82                         X_Audio_startDetectionBackend(\r
  83                                 X_Audio_BACKENDS[ 0 ], this,\r
  84                                 X_Type_isArray( sourceList ) ? X_Array_copy( sourceList ) : [ sourceList ],\r
  85                                 opt_option || {} );\r
  86                         this[ 'listenOnce' ]( [ X_EVENT_BACKEND_READY, X_EVENT_BACKEND_NONE, X_EVENT_KILL_INSTANCE ], X_Audio_handleEvent );\r
  87                         X_ViewPort[ 'listenOnce' ]( X_EVENT_UNLOAD, this, X_AudioSprite_handleEvent );\r
  88                 },\r
  89                 \r
  90                 /**\r
  91                  * 再生。開始位置・終了位置、ループの有無、ループ以降の開始位置、ループ以降の終了位置\r
  92                  * @alias Audio.prototype.play\r
  93                  */\r
  94                 'play' : function( startTime, endTime, loop, loopStartTime, loopEndTime ){\r
  95                         var pair = X_Pair_get( this );\r
  96                         pair && pair.play( startTime, endTime, loop, loopStartTime, loopEndTime );\r
  97                         return this;\r
  98                 },\r
  99                 /**\r
 100                  * シーク\r
 101                  * @alias Audio.prototype.seek\r
 102                  */\r
 103                 'seek' : function( seekTime ){\r
 104                         var pair = X_Pair_get( this );\r
 105                         pair && pair.seek( seekTime );\r
 106                         return this;\r
 107                 },\r
 108                 /**\r
 109                  * ポーズ\r
 110                  * @alias Audio.prototype.pause\r
 111                  */\r
 112                 'pause' : function(){\r
 113                         var pair = X_Pair_get( this );\r
 114                         pair && pair.pause();\r
 115                         return this;\r
 116                 },\r
 117                 /**\r
 118                  * 状態の getter と setter\r
 119                  * @alias Audio.prototype.state\r
 120                  */\r
 121                 'state' : function( obj ){\r
 122                         var pair = X_Pair_get( this );\r
 123                         if( obj === undefined ){\r
 124                                 return pair ? pair.getState() :\r
 125                                         {\r
 126                                         'startTime'     : -1,\r
 127                                         'endTime'       : -1,\r
 128                                         'loopStartTime' : -1,\r
 129                                         'loopEndTime'   : -1,\r
 130                                         'currentTime'   : -1,\r
 131                                         'loop'          : false,\r
 132                                         'looded'        : false,\r
 133                                         'error'         : false,\r
 134                                         'playing'       : false,\r
 135                                         'source'        : this[ 'source' ] || '',\r
 136                                         'duration'      : 0\r
 137                                         };\r
 138                         };\r
 139                         pair && pair.setState( obj );\r
 140                         return this;\r
 141                 },              \r
 142                 /**\r
 143                  * ループの getter と setter\r
 144                  * @alias Audio.prototype.loop\r
 145                  */\r
 146                 'loop' : function( v ){\r
 147                         var pair = X_Pair_get( this );\r
 148                         pair && pair.loop( v );\r
 149                         return this;\r
 150                 },\r
 151                 /**\r
 152                  * ボリュームの getter と setter 実装不十分！\r
 153                  * @alias Audio.prototype.volume\r
 154                  */\r
 155                 'volume' : function( v ){\r
 156                         var pair = X_Pair_get( this );\r
 157                         pair && pair.volume( v );\r
 158                         return this;\r
 159                 },\r
 160                 /**\r
 161                  * 再生位置。\r
 162                  * @alias Audio.prototype.currentTime\r
 163                  */\r
 164                 'currentTime' : function( v ){\r
 165                         var pair = X_Pair_get( this );\r
 166                         pair && pair.currentTime( v );\r
 167                         return this;\r
 168                 },\r
 169                 /**\r
 170                  * 再生中か？\r
 171                  * @alias Audio.prototype.isPlaying\r
 172                  */\r
 173                 'isPlaying' : function(){\r
 174                         var pair = X_Pair_get( this );\r
 175                         return pair && pair.playing;\r
 176                 }\r
 177                 \r
 178         }\r
 179 );\r
 180 \r
 181 function X_Audio_handleEvent( e ){\r
 182         var backend, pair;\r
 183         \r
 184         switch( e.type ){\r
 185                 case X_EVENT_BACKEND_READY :\r
 186                         backend = X_Audio_BACKENDS[ e[ 'backendID' ] ];\r
 187                 \r
 188                         this[ 'unlisten' ]( X_EVENT_BACKEND_NONE, X_Audio_handleEvent );\r
 189                         this[ 'source' ]      = e[ 'source' ];\r
 190                         this[ 'backendName' ] = backend.backendName;\r
 191                         \r
 192                         X_Pair_create( this, backend.klass( this, e[ 'source' ], e[ 'option' ] ) );\r
 193                         this[ 'listenOnce' ]( X_EVENT_READY, X_Audio_handleEvent );\r
 194                         break;\r
 195                 \r
 196                 case X_EVENT_READY :\r
 197                         pair = X_Pair_get( this );\r
 198                         ( pair.autoplay || pair._playReserved ) && pair.actualPlay();\r
 199                         delete pair._playReserved;\r
 200                         break;\r
 201                 \r
 202                 case X_EVENT_BACKEND_NONE :\r
 203                 case X_EVENT_UNLOAD :\r
 204                         this[ 'kill' ]();\r
 205                         break;\r
 206                 \r
 207                 case X_EVENT_KILL_INSTANCE :\r
 208                         X_ViewPort[ 'unlisten' ]( X_EVENT_UNLOAD, this, X_AudioSprite_handleEvent );\r
 209                         if( backend = X_Pair_get( this ) ){\r
 210                                 backend[ 'kill' ]();\r
 211                                 X_Pair_release( this, backend );\r
 212                         };\r
 213                         break;\r
 214         };\r
 215 };\r
 216 \r
 217 \r
 218 /*\r
 219  * TODO preplayerror play してみたら error が出た、backend の変更。\r
 220  */\r
 221 \r
 222 function X_Audio_startDetectionBackend( backend, xaudio, sourceList, option ){\r
 223         var source = sourceList[ 0 ] || '', \r
 224                 ext    = X_URL_getEXT( source ),\r
 225                 sup;\r
 226         \r
 227         if( source && backend ){\r
 228                 sup      = [ xaudio, sourceList, option, source, ext ];\r
 229                 sup[ 5 ] = sup;\r
 230                 \r
 231                 xaudio[ 'listenOnce' ]( X_EVENT_COMPLETE, backend, X_Audio_onEndedDetection, sup );\r
 232                 backend.detect( xaudio, source, ext );\r
 233         } else {\r
 234                 xaudio[ 'asyncDispatch' ]( X_EVENT_BACKEND_NONE );\r
 235         };\r
 236 };\r
 237 \r
 238 function X_Audio_onEndedDetection( e, xaudio, sourceList, option, source, ext, sup ){\r
 239         var i = X_Audio_BACKENDS.indexOf( this ), backend;\r
 240         \r
 241         if( e.canPlay ){\r
 242                 xaudio[ 'asyncDispatch' ]( {\r
 243                         type          : X_EVENT_BACKEND_READY,\r
 244                         'option'      : option,\r
 245                         'source'      : source,\r
 246                         'backendName' : this[ 'backendName' ],\r
 247                         'backendID'   : i\r
 248                 } );                    \r
 249         } else {\r
 250                 console.log( 'No ' + source + ' ' + this[ 'backendName' ] );\r
 251                 if( sup[ 3 ] = source = sourceList[ sourceList.indexOf( source ) + 1 ] ){\r
 252                         sup[ 4 ] = ext    = X_URL_getEXT( source );\r
 253                         xaudio[ 'listenOnce' ]( X_EVENT_COMPLETE, this, X_Audio_onEndedDetection, sup );\r
 254                         this.detect( xaudio, source, ext );\r
 255                 } else\r
 256                 if( backend = X_Audio_BACKENDS[ i + 1 ] ){\r
 257                         X_Audio_startDetectionBackend( backend, xaudio, sourceList, option );\r
 258                 } else {\r
 259                         xaudio[ 'asyncDispatch' ]( X_EVENT_BACKEND_NONE );\r
 260                 };                              \r
 261         };\r
 262 };\r
 263 \r
 264 \r
 265 \r
 266 var X_AudioBase = X_EventDispatcher[ 'inherits' ](\r
 267         'X.AudioBase',\r
 268         X_Class.ABSTRACT,\r
 269         {\r
 270                 disatcher     : null,\r
 271                 \r
 272                 startTime     : 0,    // state_startTime\r
 273                 endTime       : -1,   // state_startTime\r
 274                 loopStartTime : -1,\r
 275                 loopEndTime   : -1,\r
 276                 seekTime      : -1,\r
 277                 duration      : 0,    //\r
 278 \r
 279                 playing       : false,\r
 280                 error         : 0,    //                \r
 281                 autoLoop      : false,\r
 282                 looped        : false,\r
 283                 autoplay      : false,//\r
 284                 gain          : 0.5,\r
 285                 \r
 286                 _playReserved : false,\r
 287                 \r
 288                 play : function( startTime, endTime, loop, loopStartTime, loopEndTime ){\r
 289                         if( 0 <= startTime ){\r
 290                                 this.setState( {\r
 291                                         'currentTime'   : startTime,\r
 292                                         'startTime'     : startTime,\r
 293                                         'endTime'       : endTime,\r
 294                                         'loop'          : loop,\r
 295                                         'looped'        : false,\r
 296                                         'loopStartTime' : loopStartTime,\r
 297                                         'loopEndTime'   : loopEndTime\r
 298                                 } );\r
 299                         };\r
 300                         // canPlay() : autoplay = true\r
 301                         this.actualPlay();\r
 302                 },\r
 303                 \r
 304                 seek : function( seekTime ){\r
 305                         if( seekTime < X_Audio_getEndTime( this ) ){\r
 306                                 this.setState( { 'currentTime' : seekTime } );\r
 307                         };\r
 308                 },\r
 309                 \r
 310                 pause : function(){\r
 311                         this.seekTime = this.getActualCurrentTime();\r
 312                         this.playing && this.actualPause();\r
 313                         // delete this.autoplay\r
 314                         // delete this.playing\r
 315                 },              \r
 316                 \r
 317                 loop : function( v ){\r
 318                         if( v === undefined ){\r
 319                                 return this.autoLoop;\r
 320                         };\r
 321                         this.setState( { 'loop' : v } );\r
 322                 },\r
 323 \r
 324                 volume : function( v ){\r
 325                         if( v === undefined ){\r
 326                                 return this.gain;\r
 327                         };\r
 328                         this.setState( { 'volume' : v } );\r
 329                 },\r
 330 \r
 331                 currentTime : function( v ){\r
 332                         if( v === undefined ){\r
 333                                 return this.playing ? this.getActualCurrentTime() : this.seekTime;\r
 334                         };\r
 335                         this.setState( { 'currentTime' : v } );\r
 336                 },\r
 337                 \r
 338                 getState : function(){\r
 339                         \r
 340                     return {\r
 341                         'startTime'     : this.startTime,\r
 342                         'endTime'       : this.endTime < 0 ? this.duration : this.endTime,\r
 343                         'loopStartTime' : this.loopStartTime < 0 ? this.startTime : this.loopStartTime,\r
 344                         'loopEndTime'   : this.loopEndTime < 0 ? ( this.endTime || this.duration ) : this.loopEndTime,\r
 345                         'loop'          : this.autoLoop,\r
 346                         'looped'        : this.looped,\r
 347                         'volume'        : this.gain,\r
 348                         'playing'       : this.playing,                         \r
 349                         'duration'      : this.duration,\r
 350                         \r
 351                         'currentTime'  : this.playing ? this.getActualCurrentTime() : this.seekTime,\r
 352                         'error'        : this.getActualError ? this.getActualError() : this.error\r
 353                     };\r
 354                 },\r
 355                 \r
 356                 setState : function( obj ){\r
 357                         var playing = this.playing,\r
 358                                 k, v,\r
 359                                 end = 0, seek = 0, volume = 0;\r
 360                         \r
 361                         for( k in obj ){\r
 362                                 v = obj[ k ];\r
 363                                 switch( k ){\r
 364                                         case 'currentTime'   :\r
 365                                                 v = X_Audio_timeStringToNumber( v );\r
 366                                                 if( X_Type_isNumber( v ) ){\r
 367                                                         if( playing ){\r
 368                                                                 if( this.getActualCurrentTime() !== v ){\r
 369                                                                         seek = 2;\r
 370                                                                         this.seekTime = v;\r
 371                                                                 };                                                              \r
 372                                                         } else {\r
 373                                                                 this.seekTime = v;\r
 374                                                         };\r
 375                                                 } else {\r
 376                                                         continue;\r
 377                                                 };\r
 378                                                 break;\r
 379                                                         \r
 380                                         case 'startTime'     :\r
 381                                                 v = X_Audio_timeStringToNumber( v );\r
 382                                                 if( v || v === 0 ){\r
 383                                                         if( this.startTime !== v ){\r
 384                                                                 this.startTime = v;                                     \r
 385                                                         };\r
 386                                                 } else {\r
 387                                                         delete this.startTime;\r
 388                                                 };\r
 389                                                 break;\r
 390                                         \r
 391                                         case 'endTime'       :\r
 392                                                 v = X_Audio_timeStringToNumber( v );\r
 393                                                 if( v || v === 0 ){\r
 394                                                         if( this.endTime !== v ){\r
 395                                                                 this.endTime = v;\r
 396                                                                 if( playing ) end = 1;                                          \r
 397                                                         };\r
 398                                                 } else {\r
 399                                                         delete this.endTime;\r
 400                                                         if( playing ) end = 1;\r
 401                                                 };\r
 402                                                 break;\r
 403                                                 \r
 404                                         case 'loopStartTime' :\r
 405                                                 v = X_Audio_timeStringToNumber( v );\r
 406                                                 if( v || v === 0 ){\r
 407                                                         if( this.loopStartTime !== v ){\r
 408                                                                 this.loopStartTime = v;                                 \r
 409                                                         };\r
 410                                                 } else {\r
 411                                                         delete this.loopStartTime;\r
 412                                                 };\r
 413                                                 break;\r
 414                                                 \r
 415                                         case 'loopEndTime'   :\r
 416                                                 v = X_Audio_timeStringToNumber( v );\r
 417                                                 if( v || v === 0 ){\r
 418                                                         if( this.loopEndTime !== v ){\r
 419                                                                 this.loopEndTime = v;\r
 420                                                                 if( playing ) end = 1;                                          \r
 421                                                         };\r
 422                                                 } else {\r
 423                                                         delete this.loopEndTime;\r
 424                                                         if( playing ) end = 1;\r
 425                                                 };\r
 426                                                 break;\r
 427                 \r
 428                                         case 'looped' :\r
 429                                                 if( X_Type_isBoolean( v ) && this.looped !== v ){\r
 430                                                         this.looped = v;\r
 431                                                         if( playing ) seek = 2;\r
 432                                                 };\r
 433                                                 break;\r
 434                                                 \r
 435                                         case 'loop' :\r
 436                                                 if( X_Type_isBoolean( v ) && this.autoLoop !== v ){\r
 437                                                         this.autoLoop = v;\r
 438                                                 };\r
 439                                                 break;\r
 440                                                 \r
 441                                         case 'autoplay' :\r
 442                                                 if( X_Type_isBoolean( v ) && this.autoplay !== v ){\r
 443                                                         this.autoplay = v;\r
 444                                                 };\r
 445                                                 break;\r
 446                 \r
 447                                         case 'volume' :\r
 448                                                 if( X_Type_isNumber( v ) ){\r
 449                                                         v = v < 0 ? 0 : 1 < v ? 1 : v;\r
 450                                                         if( this.gain !== v ){\r
 451                                                                 this.gain = v;\r
 452                                                                 // if playing -> update\r
 453                                                                 if( playing ) volume = 4;\r
 454                                                         };\r
 455                                                 };\r
 456                                                 break;\r
 457                                         case 'useVideo' :\r
 458                                                 break;\r
 459                                         default :\r
 460                                                 alert( 'bad arg! ' + k );\r
 461                                 };\r
 462                         };\r
 463                         \r
 464                         if( this.endTime < this.startTime ||\r
 465                                 ( this.loopEndTime < 0 ? this.endTime : this.loopEndTime ) < ( this.loopStartTime < 0 ? this.startTime : this.loopStartTime ) ||\r
 466                                 X_Audio_getEndTime( this ) < this.seekTime// ||\r
 467                                 //this.duration < this.endTime\r
 468                         ){\r
 469                                 console.log( 'setState 0:' + this.startTime + ' -> ' + this.endTime + ' looped:' + this.looped + ' 1:' + this.loopStartTime + ' -> ' + this.loopEndTime );\r
 470                                 return;\r
 471                         };\r
 472                         \r
 473                         v = end + seek + volume;\r
 474                         return v && this.playing && this.afterUpdateState( v );\r
 475                 }\r
 476                 \r
 477         }\r
 478 );\r
 479 \r
 480 \r
 481 function X_Audio_timeStringToNumber( time ){\r
 482         var ary, ms, s = 0, m = 0, h = 0;\r
 483 \r
 484         if( X_Type_isNumber( time ) ) return time;\r
 485         if( !X_Type_isString( time ) || !time.length ) return;\r
 486 \r
 487         ary = time.split( '.' );\r
 488         ms  = parseFloat( ( ary[ 1 ] + '000' ).substr( 0, 3 ) ) || 0;\r
 489         \r
 490         ary = ary[ 0 ].split( ':' );\r
 491         if( 3 < ary.length ) return;\r
 492         \r
 493         switch( ary.length ){\r
 494                 case 0 :\r
 495                         break;\r
 496                 case 1 :\r
 497                         s = parseFloat( ary[ 0 ] ) || 0;\r
 498                         break;\r
 499                 case 2 :\r
 500                         m = parseFloat( ary[ 0 ] ) || 0;\r
 501                         s = parseFloat( ary[ 1 ] ) || 0;\r
 502                         if( 60 <= s ) alert( 'invalid time string ' + time );\r
 503                         break;\r
 504                 case 3 :\r
 505                         h = parseFloat( ary[ 0 ] ) || 0;\r
 506                         m = parseFloat( ary[ 1 ] ) || 0;\r
 507                         s = parseFloat( ary[ 2 ] ) || 0;\r
 508                         if( 60 <= s ) alert( 'invalid time string ' + time );\r
 509                         if( 60 <= m ) alert( 'invalid time string ' + time );\r
 510                         break;\r
 511                 default :\r
 512                         alert( 'invalid time string ' + time );\r
 513         };\r
 514         ms = ( h * 3600 + m * 60 + s ) * 1000 + ms;\r
 515         return ms < 0 ? 0 : ms;\r
 516 };\r
 517 \r
 518 function X_Audio_getStartTime( audioBase, endTime, delSeekTime ){\r
 519         var seek = audioBase.seekTime;\r
 520         \r
 521         if( delSeekTime ) delete audioBase.seekTime;\r
 522         \r
 523         if( 0 <= seek ){\r
 524                 if( audioBase.duration <= seek || endTime < seek ) return 0;\r
 525                 return seek;\r
 526         };\r
 527         \r
 528         if( audioBase.looped && 0 <= audioBase.loopStartTime ){\r
 529                 if( audioBase.duration <= audioBase.loopStartTime || endTime < audioBase.loopStartTime ) return 0;\r
 530                 return audioBase.loopStartTime;\r
 531         };\r
 532         \r
 533         if( audioBase.startTime < 0 || audioBase.duration <= audioBase.startTime ) return 0;\r
 534         return audioBase.startTime;\r
 535 };\r
 536 \r
 537 function X_Audio_getEndTime( audioBase ){\r
 538         var duration = audioBase.duration;\r
 539         \r
 540         if( audioBase.looped && 0 <= audioBase.loopEndTime ){\r
 541                 if( duration <= audioBase.loopEndTime ) return duration;\r
 542                 return audioBase.loopEndTime;\r
 543         };\r
 544         \r
 545         if( audioBase.endTime < 0 || duration <= audioBase.endTime ) return duration;\r
 546         return audioBase.endTime;\r
 547 };\r
 548 \r