CPSound.j

Go to the documentation of this file.

/*
 * CPSound.j
 * AppKit
 *
 * Created by Antoine Mercadal
 * Copyright 2010, Antoine Mercadal
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */


@typedef HTMLAudioElement

@protocol CPSoundDelegate <CPObject>

@optional
- (void)sound:(CPSound)aSound didFinishPlaying:(BOOL)finishedLoading;

@end


var CPSoundDelegate_sound_didFinishPlaying_ = 1 << 1;

CPSoundLoadStateEmpty       = 0;
CPSoundLoadStateLoading     = 1;
CPSoundLoadStateCanBePlayed = 2;
CPSoundLoadStateError       = 3;

CPSoundPlayBackStatePlay    = 0;
CPSoundPlayBackStateStop    = 1;
CPSoundPlayBackStatePause   = 2;


@implementation CPSound : CPObject
{
    CPString            _name;
    id                  _delegate;

    BOOL                _playRequestBeforeLoad;
    HTMLAudioElement    _audioTag;
    int                 _loadStatus;
    int                 _playBackStatus;
    unsigned            _implementedDelegateMethods;
}

#pragma mark -
#pragma mark Initialization

- (id)init
{
    if (self = [super init])
    {
        _loadStatus = CPSoundLoadStateEmpty;
//        _loops = NO;
        _audioTag = document.createElement("audio");
        _audioTag.preload = YES;
        _playRequestBeforeLoad = NO;

        _audioTag.addEventListener("canplay", function()
        {
            [[CPRunLoop currentRunLoop] limitDateForMode:CPDefaultRunLoopMode];
            [self _soundDidload];
        }, true);

        _audioTag.addEventListener("ended", function()
        {
            [[CPRunLoop currentRunLoop] limitDateForMode:CPDefaultRunLoopMode];
            [self _soundDidEnd];
        }, true);

        _audioTag.addEventListener("error", function()
        {
            [[CPRunLoop currentRunLoop] limitDateForMode:CPDefaultRunLoopMode];
            [self _soundError];
        }, true);
    }

    return self;
}

- (id)initWithContentsOfFile:(CPString)aFile byReference:(BOOL)byRef
{
    if (self = [self init])
    {
        _loadStatus = CPSoundLoadStateLoading;
        _audioTag.src = aFile;
    }

    return self;
}

- (id)initWithContentsOfURL:(CPURL)aURL byReference:(BOOL)byRef
{
    return [self initWithContentsOfFile:[aURL absoluteString] byReference:NO];
}

- (id)initWithData:(CPData)someData
{
    if (self = [self init])
    {
        _loadStatus = CPSoundLoadStateLoading;
        _audioTag.src = [someData rawString];
    }

    return self;
}


#pragma mark -
#pragma mark Delegate methods

- (void)setDelegate:(id)aDelegate
{
    if (_delegate === aDelegate)
        return;

    _delegate = aDelegate;
    _implementedDelegateMethods = 0;

    if ([_delegate respondsToSelector:@selector(sound:didFinishPlaying:)])
        _implementedDelegateMethods |= CPSoundDelegate_sound_didFinishPlaying_;
}

#pragma mark -
#pragma mark Events listener

- (void)_soundDidload
{
    _loadStatus = CPSoundLoadStateCanBePlayed;

    if (_playRequestBeforeLoad)
    {
        _playRequestBeforeLoad = NO;
        [self play];
    }
}

- (void)_soundDidEnd
{
    if (![self loops])
        [self stop];
}

- (void)_soundError
{
    _loadStatus = CPSoundLoadStateError;
    CPLog.error("Cannot load sound. Maybe the format of your sound is not compatible with your browser.");
}


#pragma mark -
#pragma mark Media controls

- (BOOL)play
{
    if (_loadStatus === CPSoundLoadStateLoading)
    {
        _playRequestBeforeLoad = YES;
        return YES;
    }

    if ((_loadStatus !== CPSoundLoadStateCanBePlayed)
        || (_playBackStatus === CPSoundPlayBackStatePlay))
        return NO;

    _audioTag.play();
    _playBackStatus = CPSoundPlayBackStatePlay;

    return YES;
}

- (BOOL)stop
{
    if ((_loadStatus !== CPSoundLoadStateCanBePlayed)
        || (_playBackStatus === CPSoundPlayBackStateStop))
        return NO;

    _audioTag.pause();
    _audioTag.currentTime = 0.0;
    _playBackStatus = CPSoundPlayBackStateStop;

    [self _sendDelegateSoundDidFinishPlaying:YES];

    return YES;
}

- (BOOL)pause
{
    if ((_loadStatus !== CPSoundLoadStateCanBePlayed)
        || (_playBackStatus === CPSoundPlayBackStatePause))
        return NO;

    _audioTag.pause();
    _playBackStatus = CPSoundPlayBackStatePause;

    return YES;
}

- (BOOL)resume
{
    if ((_loadStatus !== CPSoundLoadStateCanBePlayed)
        || (_playBackStatus !== CPSoundPlayBackStatePause))
        return NO;

    _audioTag.play();
    _playBackStatus = CPSoundPlayBackStatePlay;

    return YES;
}

- (BOOL)loops
{
    return _audioTag.loop;
}

- (void)setLoops:(BOOL)shouldLoop
{
    _audioTag.loop = shouldLoop;
}

- (double)volume
{
    return _audioTag.volume;
}

- (void)setVolume:(double)aVolume
{
    if (aVolume > 1.0)
        aVolume = 1.0;
    else if (aVolume < 0.0)
        aVolume = 0.0;

    _audioTag.volume = aVolume;
}

#pragma mark -
#pragma mark Accessors

- (double)duration
{
    return _audioTag.duration;
}

- (BOOL)isPlaying
{
    return (_playBackStatus === CPSoundPlayBackStatePlay);
}

@end


@implementation CPSound (CPSoundDelegate)

- (void)_sendDelegateSoundDidFinishPlaying:(BOOL)finishedPlaying
{
    if (!(_implementedDelegateMethods & CPSoundDelegate_sound_didFinishPlaying_))
        return;

    [_delegate sound:self didFinishPlaying:finishedPlaying];
}

@end

@implementation CPSound (CPSynthesizedAccessors)

- (CPString)name
{
    return _name;
}

- (void)setName:(CPString)aValue
{
    _name = aValue;
}

- (id)delegate
{
    return _delegate;
}

- (void)setDelegate:(id)aValue
{
    _delegate = aValue;
}

@end