13 var X_Audio_BACKENDS = []; // Array.<Hash>
\r
16 * <p>複数のバックエンドから、与えられた音声を再生可能なものを見つけ、音声を再生します。
\r
17 * <p>HTMLAudio の動作・機能がブラウザ毎にバラバラなのに業を煮やし、メソッドやイベントは独自に定義しています。
\r
18 * <h4>バックエンドの種類</h4>
\r
19 * <p>HTMLAudio, WebAudio, Silverlight
\r
22 * <dt>X.Event.BACKEND_READY <dd>音声(src リスト)を再生可能なバックエンドが見つかった。
\r
23 * <dt>X.Event.BACKEND_NONE <dd>音声を再生可能なバックエンドが見つからなかった。
\r
24 * <dt>X.Event.READY <dd>再生可能、実際の状態は canplay から loadeddata まで様々、、、
\r
25 * <dt>X.Event.ERROR <dd><ul>
\r
26 * <li> 1 : ユーザーによってメディアの取得が中断された
\r
27 * <li> 2 : ネットワークエラー
\r
28 * <li> 3 : メディアのデコードエラー
\r
29 * <li> 4 : メディアがサポートされていない
\r
31 * <dt>X.Event.MEDIA_PLAYING <dd>再生中に1秒以下のタイミングで発生.currentTime が取れる?
\r
32 * <dt>X.Event.MEDIA_LOOP <dd>ループ直前に発生、キャンセル可能
\r
33 * <dt>X.Event.MEDIA_LOOPED <dd>ループ時に発生
\r
34 * <dt>X.Event.MEDIA_ENDED <dd>再生位置の(音声の)最後についた
\r
35 * <dt>X.Event.MEDIA_PAUSED <dd>ポーズした
\r
36 * <dt>X.Event.MEDIA_WAITING <dd>再生中に音声が待機状態に。間もなく X.Event.MEDIA_PLAYING に移行。
\r
37 * <dt>X.Event.MEDIA_SEEKING <dd>シーク中に音声が待機状態に。間もなく X.Event.MEDIA_PLAYING に移行。
\r
41 * @class 各種オーディオ機能をラップしインターフェイスを共通化する。
\r
43 * @extends {EventDispatcher}
\r
44 * @param {array|string} sourceList
\r
45 * @param {object=} opt_option
\r
47 * var audio = X.Audio( [ 'etc/special.mp3', 'etc/special.ogg', 'etc/special.wav' ] )
\r
48 .listenOnce( X.Event.READY, onReady );
\r
50 X[ 'Audio' ] = X_EventDispatcher[ 'inherits' ](
\r
52 X_Class.POOL_OBJECT,
\r
55 * 音声の url。X.Event.BACKEND_READY で設定される。
\r
56 * @alias Audio.prototype.source
\r
61 * 音声再生バックエンドの名前。X.Event.BACKEND_READY で設定される。
\r
62 * @alias Audio.prototype.backendName
\r
67 'Constructor' : function( sourceList, opt_option ){
\r
68 X_Audio_startDetectionBackend(
\r
69 X_Audio_BACKENDS[ 0 ], this,
\r
70 X_Type_isArray( sourceList ) ? X_Object_cloneArray( sourceList ) : [ sourceList ],
\r
72 this[ 'listenOnce' ]( [ X_EVENT_BACKEND_READY, X_EVENT_BACKEND_NONE, X_EVENT_KILL_INSTANCE ], X_Audio_handleEvent );
\r
76 * 再生。開始位置・終了位置、ループの有無、ループ以降の開始位置、ループ以降の終了位置
\r
77 * @alias Audio.prototype.play
\r
79 'play' : function( startTime, endTime, loop, loopStartTime, loopEndTime ){
\r
80 var pair = X_Pair_get( this );
\r
81 pair && pair.play( startTime, endTime, loop, loopStartTime, loopEndTime );
\r
86 * @alias Audio.prototype.seek
\r
88 'seek' : function( seekTime ){
\r
89 var pair = X_Pair_get( this );
\r
90 pair && pair.seek( seekTime );
\r
95 * @alias Audio.prototype.pause
\r
97 'pause' : function(){
\r
98 var pair = X_Pair_get( this );
\r
99 pair && pair.pause();
\r
103 * 状態の getter と setter
\r
104 * @alias Audio.prototype.state
\r
106 'state' : function( obj ){
\r
107 var pair = X_Pair_get( this );
\r
108 if( obj === undefined ){
\r
109 return pair ? pair.getState() :
\r
113 'loopStartTime' : -1,
\r
114 'loopEndTime' : -1,
\r
115 'currentTime' : -1,
\r
120 'source' : this[ 'source' ] || '',
\r
124 pair && pair.setState( obj );
\r
128 * ループの getter と setter
\r
129 * @alias Audio.prototype.loop
\r
131 'loop' : function( v ){
\r
132 var pair = X_Pair_get( this );
\r
133 pair && pair.loop( v );
\r
137 * ボリュームの getter と setter 実装不十分!
\r
138 * @alias Audio.prototype.volume
\r
140 'volume' : function( v ){
\r
141 var pair = X_Pair_get( this );
\r
142 pair && pair.volume( v );
\r
147 * @alias Audio.prototype.currentTime
\r
149 'currentTime' : function( v ){
\r
150 var pair = X_Pair_get( this );
\r
151 pair && pair.currentTime( v );
\r
156 * @alias Audio.prototype.isPlaying
\r
158 'isPlaying' : function(){
\r
159 var pair = X_Pair_get( this );
\r
160 return pair && pair.playing;
\r
166 function X_Audio_handleEvent( e ){
\r
170 case X_EVENT_BACKEND_READY :
\r
171 backend = X_Audio_BACKENDS[ e[ 'backendID' ] ];
\r
173 this[ 'unlisten' ]( X_EVENT_BACKEND_NONE, X_Audio_handleEvent );
\r
174 this[ 'source' ] = e[ 'source' ];
\r
175 this[ 'backendName' ] = backend.backendName;
\r
176 X_Pair_create( this, backend.klass( this, e[ 'source' ], e[ 'option' ] ) );
\r
179 case X_EVENT_BACKEND_NONE :
\r
183 case X_EVENT_KILL_INSTANCE :
\r
184 backend = X_Pair_get( this );
\r
185 backend && backend[ 'kill' ]();
\r
186 X_Pair_release( this, backend );
\r
193 * TODO preplayerror play してみたら error が出た、backend の変更。
\r
196 function X_Audio_startDetectionBackend( backend, xaudio, sourceList, option ){
\r
197 var source = sourceList[ 0 ] || '',
\r
198 ext = X_URL_getEXT( source ),
\r
201 if( source && backend ){
\r
202 sup = [ xaudio, sourceList, option, source, ext ];
\r
205 xaudio[ 'listenOnce' ]( X_EVENT_COMPLETE, backend, X_Audio_onEndedDetection, sup );
\r
206 backend.detect( xaudio, source, ext );
\r
208 xaudio[ 'asyncDispatch' ]( X_EVENT_BACKEND_NONE );
\r
212 function X_Audio_onEndedDetection( e, xaudio, sourceList, option, source, ext, sup ){
\r
213 var i = X_Audio_BACKENDS.indexOf( this ), backend;
\r
216 xaudio[ 'asyncDispatch' ]( {
\r
217 type : X_EVENT_BACKEND_READY,
\r
220 'backendName' : this[ 'backendName' ],
\r
224 console.log( 'No ' + source + ' ' + this[ 'backendName' ] );
\r
225 if( sup[ 3 ] = source = sourceList[ sourceList.indexOf( source ) + 1 ] ){
\r
226 sup[ 4 ] = ext = X_URL_getEXT( source );
\r
227 xaudio[ 'listenOnce' ]( X_EVENT_COMPLETE, this, X_Audio_onEndedDetection, sup );
\r
228 this.detect( xaudio, source, ext );
\r
230 if( backend = X_Audio_BACKENDS[ i + 1 ] ){
\r
231 X_Audio_startDetectionBackend( backend, xaudio, sourceList, option );
\r
233 xaudio[ 'asyncDispatch' ]( X_EVENT_BACKEND_NONE );
\r
240 var X_Audio_AbstractAudioBackend = X_EventDispatcher[ 'inherits' ](
\r
241 'X.AbstractAudioBackend',
\r
250 loopStartTime : -1,
\r
262 play : function( startTime, endTime, loop, loopStartTime, loopEndTime ){
\r
263 if( 0 <= startTime ){
\r
265 currentTime : startTime,
\r
266 startTime : startTime,
\r
269 loopStartTime : loopStartTime,
\r
270 loopEndTime : loopEndTime
\r
276 seek : function( seekTime ){
\r
277 if( seekTime < X_AudioWrapper_getEndTime( this ) ){
\r
278 this.setState( { currentTime : seekTime } );
\r
282 pause : function(){
\r
283 this.playing && this.actualPause();
\r
286 loop : function( v ){
\r
287 if( v === undefined ){
\r
288 return this.autoLoop;
\r
290 this.setState( { loop : v } );
\r
293 volume : function( v ){
\r
294 if( v === undefined ){
\r
297 this.setState( { volume : v } );
\r
300 currentTime : function( v ){
\r
301 if( v === undefined ){
\r
302 return this.playing ? this.getActualCurrentTime() : this.seekTime;
\r
304 this.setState( { currentTime : v } );
\r
307 getState : function(){
\r
310 'startTime' : this.startTime,
\r
311 'endTime' : this.endTime < 0 ? this.duration : this.endTime,
\r
312 'loopStartTime' : this.loopStartTime < 0 ? this.startTime : this.loopStartTime,
\r
313 'loopEndTime' : this.loopEndTime < 0 ? ( this.endTime || this.duration ) : this.loopEndTime,
\r
314 'loop' : this.autoLoop,
\r
315 'looped' : this.looped,
\r
316 'volume' : this.gain,
\r
317 'playing' : this.playing,
\r
318 'duration' : this.duration,
\r
320 'currentTime' : this.playing ? this.getActualCurrentTime() : this.seekTime,
\r
321 'error' : this.getActualError ? this.getActualError() : this.error
\r
325 setState : function( obj ){
\r
326 var playing = this.playing,
\r
328 end = 0, seek = 0, volume = 0;
\r
333 case 'currentTime' :
\r
334 v = X_AudioWrapper_timeStringToNumber( v );
\r
335 if( X_Type_isNumber( v ) ){
\r
337 if( this.getActualCurrentTime() !== v ){
\r
350 v = X_AudioWrapper_timeStringToNumber( v );
\r
351 if( v || v === 0 ){
\r
352 if( this.startTime !== v ){
\r
353 this.startTime = v;
\r
356 delete this.startTime;
\r
361 v = X_AudioWrapper_timeStringToNumber( v );
\r
362 if( v || v === 0 ){
\r
363 if( this.endTime !== v ){
\r
365 if( playing ) end = 1;
\r
368 delete this.endTime;
\r
369 if( playing ) end = 1;
\r
373 case 'loopStartTime' :
\r
374 v = X_AudioWrapper_timeStringToNumber( v );
\r
375 if( v || v === 0 ){
\r
376 if( this.loopStartTime !== v ){
\r
377 this.loopStartTime = v;
\r
380 delete this.loopStartTime;
\r
384 case 'loopEndTime' :
\r
385 v = X_AudioWrapper_timeStringToNumber( v );
\r
386 if( v || v === 0 ){
\r
387 if( this.loopEndTime !== v ){
\r
388 this.loopEndTime = v;
\r
389 if( playing ) end = 1;
\r
392 delete this.loopEndTime;
\r
393 if( playing ) end = 1;
\r
398 if( X_Type_isBoolean( v ) && this.looped !== v ){
\r
400 if( playing ) seek = 2;
\r
405 if( X_Type_isBoolean( v ) && this.autoLoop !== v ){
\r
411 if( X_Type_isBoolean( v ) && this.autoplay !== v ){
\r
417 if( X_Type_isNumber( v ) ){
\r
418 v = v < 0 ? 0 : 1 < v ? 1 : v;
\r
419 if( this.gain !== v ){
\r
421 // if playing -> update
\r
422 if( playing ) volume = 4;
\r
429 if( this.endTime < this.startTime ||
\r
430 ( this.loopEndTime < 0 ? this.endTime : this.loopEndTime ) < ( this.loopStartTime < 0 ? this.startTime : this.loopStartTime ) ||
\r
431 X_AudioWrapper_getEndTime( this ) < this.seekTime// ||
\r
432 //this.duration < this.endTime
\r
434 console.log( 'setState 0:' + this.startTime + ' -> ' + this.endTime + ' d:' + this.duration + ' 1:' + this.loopStartTime + ' -> ' + this.loopEndTime );
\r
438 v = end + seek + volume;
\r
439 return v && this.afterUpdateState( v );
\r
446 function X_AudioWrapper_timeStringToNumber( time ){
\r
447 var ary, ms, s = 0, m = 0, h = 0;
\r
448 if( X_Type_isNumber( time ) ) return time;
\r
449 if( !X_Type_isString( time ) || !time.length ) return;
\r
451 ary = time.split( '.' );
\r
452 ms = parseInt( ( ary[ 1 ] + '000' ).substr( 0, 3 ) ) || 0;
\r
454 ary = ary[ 0 ].split( ':' );
\r
455 if( 3 < ary.length ) return;
\r
457 switch( ary.length ){
\r
461 s = parseInt( ary[ 0 ] ) || 0;
\r
464 m = parseInt( ary[ 0 ] ) || 0;
\r
465 s = parseInt( ary[ 1 ] ) || 0;
\r
466 if( 60 <= s ) alert( 'invalid time string ' + time );
\r
469 h = parseInt( ary[ 0 ] ) || 0;
\r
470 m = parseInt( ary[ 1 ] ) || 0;
\r
471 s = parseInt( ary[ 2 ] ) || 0;
\r
472 if( 60 <= s ) alert( 'invalid time string ' + time );
\r
473 if( 60 <= m ) alert( 'invalid time string ' + time );
\r
476 alert( 'invalid time string ' + time );
\r
478 ms = ( h * 3600 + m * 60 + s ) * 1000 + ms;
\r
479 return ms < 0 ? 0 : ms;
\r
482 function X_AudioWrapper_getStartTime( audioWrapper, endTime, delSeekTime ){
\r
483 var seek = audioWrapper.seekTime;
\r
484 if( delSeekTime ) delete audioWrapper.seekTime;
\r
487 if( audioWrapper.duration <= seek || endTime < seek ) return 0;
\r
491 if( audioWrapper.looped && 0 <= audioWrapper.loopStartTime ){
\r
492 if( audioWrapper.duration <= audioWrapper.loopStartTime || endTime < audioWrapper.loopStartTime ) return 0;
\r
493 return audioWrapper.loopStartTime;
\r
496 if( audioWrapper.startTime < 0 || audioWrapper.duration <= audioWrapper.startTime ) return 0;
\r
497 return audioWrapper.startTime;
\r
500 function X_AudioWrapper_getEndTime( audioWrapper ){
\r
501 var duration = audioWrapper.duration;
\r
503 if( audioWrapper.looped && 0 <= audioWrapper.loopEndTime ){
\r
504 if( duration <= audioWrapper.loopEndTime ) return duration;
\r
505 return audioWrapper.loopEndTime;
\r
508 if( audioWrapper.endTime < 0 || duration <= audioWrapper.endTime ) return duration;
\r
509 return audioWrapper.endTime;
\r