Method apply

src/actions/Play.ts:313–378

({ paused = false } = {})

  }

  override async apply({ paused = false } = {}): Promise<void> {
    // Check if the audio should have a fade time
    const fadePosition = this.props.indexOf('fade');
    const shouldLoop = this.props.indexOf('loop') > -1;
    const volumePercentage = this.props.indexOf('volume') > -1 ? parseInt(this.props[this.props.indexOf('volume') + 1]) / 100 : 1;
    const volume = this.mediaVolume * volumePercentage;

    // Create player if it doesn't exist yet
    if (this.player === null) {
      this.player = await this.createAudioPlayer(paused, volume);
      this.engine.mediaPlayer(this.type, this.mediaKey, this.player);
    }

    if (this.player instanceof AudioPlayer) {
      // Make the audio loop if it was provided as a prop
      if (shouldLoop) {
        this.player.loop = true;
      }

      // Set volume through the AudioPlayer setter
      this.player.volume = volume;
      this.player.dataset.volumePercentage = (volumePercentage * 100).toString();

      this.player.onended = () => {
        const endState: Record<string, any> = {};
        endState[this.type] = this.engine.state(this.type).filter((s: any) => s.statement !== this._statement);
        this.engine.state(endState);
        this.engine.removeMediaPlayer(this.type, this.mediaKey);
      };

      if (paused === true) {
        return Promise.resolve();
      }

      // Start playback first, then apply fade if requested
      await this.player.play();

      if (fadePosition > -1) {
        const fadeTime = this.props[fadePosition + 1];
        const match = fadeTime.match(/\d*(\.\d*)?/);
        const duration = match ? parseFloat(match[0]) : 0;
        // Don't await fadeIn - let it run in background while playback continues
        this.player.fadeIn(duration, this.player.volume);
      }

      return;

    }
    else if (this.player instanceof Array) {
      const promises = [];
      for (const player of this.player) {
        if (player.paused && !player.ended) {
          if (fadePosition > -1) {
            const fadeTime = this.props[fadePosition + 1];
            const match = fadeTime.match(/\d*(\.\d*)?/);
            const duration = match ? parseFloat(match[0]) : 0;
            player.fadeIn(duration);
          }