p5.js MediaElement clearCues() 方法

p5.js MediaElement clearCues() 方法是一个用于清除媒体元素中所有处于活动状态的单词提示(cue)的方法。单词提示(cue)是指为媒体元素设置的时刻标记。当媒体元素中播放头(Playing head)进入某个单词提示(cue)所标记的时刻时，就会触发对应的回调函数(Callback Function)。clearCues() 方法可以清除这些处于活动状态的单词提示(cue)，避免它们引起不必要的回调操作。

语法

mediaElement.clearCues();

参数

没有参数。

返回值

没有返回值。

示例

以下示例展示了如何使用 clearCues() 方法清除媒体元素中所有处于活动状态的单词提示(cue)。

let audio;

function setup() {
  createCanvas(400, 300);
  audio = createAudio('music.mp3', () => {
    console.log('audio loaded');
    // Add cues to the audio file.
    audio.addCue(1, showOne);
    audio.addCue(3, showThree);
    audio.addCue(5, showFive);
  });

  // Play the audio file.
  audio.play();
}

function draw() {
  background(220);
}

// Callbacks functions for cues.
function showOne() {
  console.log('One');
}

function showThree() {
  console.log('Three');
}

function showFive() {
  console.log('Five');
}

// Clear all cues when mouse is clicked.
function mouseClicked() {
  audio.clearCues();
}

在这个例子中，我们只需要在 setup() 函数中使用 addCue() 方法添加了三个单词提示(cue)，并分别将它们绑定到了三个不同的回调函数中。同时，我们还将 clearCues() 方法绑定到了 mouseClicked() 函数中，当鼠标单击时就会清除音频文件中所有处于活动状态的单词提示(cue)。

注意事项

• clearCues() 方法只能清除媒体元素中处于活动状态的单词提示(cue)，如果添加的单词提示(cue)没有被激活则不会被清除。

参考连接

• p5.MediaElement Documentation