累计: 0

音频播放 audio player

0.00

★25次@未来之窗

A:赛忞初雪

上架: 2025-10-22 14:07:58

         收藏
 

四方仙域传送阵         

音频播放功能说明书

音频播放功能说明书

未来之窗昭和仙君 - cyberwin_fairyalliance_webquery

一、功能概述

该音频播放功能提供了一系列方法,用于控制音频的播放、停止、暂停和继续播放。通过这些方法,开发者可以方便地在网页中实现音频的交互操作。

二、核心函数说明

1. fairyalliance_playAudio(url, startTime = 0, endTime = null)

参数 说明
url(必填) 音频文件的 URL,类型为字符串。
startTime(可选) 播放起始时间,单位为秒,默认值为 0。
endTime(可选) 播放终止时间,单位为秒,null 表示播放至结束。

返回值 实例,支持链式调用。

功能:播放指定 URL 的音频文件,并可设置播放的起始和终止时间。

2. fairyalliance_stopAudio()

参数 说明

返回值 实例,支持链式调用。

功能:停止当前播放的音频,清除监听事件。

3. fairyalliance_pauseAudio()

参数 说明

返回值 实例,支持链式调用。

功能:暂停当前播放的音频,保留播放进度。

4. fairyalliance_continueAudio()

参数 说明

返回值 实例,支持链式调用。

功能:从暂停位置继续播放音频。

三、别名方法

为了方便使用,还提供了以下别名方法:

  • 未来之窗_语音交互_音频播放(url, startTime = 0, endTime = null):等同于 fairyalliance_playAudio
  • 未来之窗_语音交互_音频停止():等同于 fairyalliance_stopAudio
  • 未来之窗_语音交互_音频继续():等同于 fairyalliance_continueAudio
  • 未来之窗_语音交互_音频暂停():等同于 fairyalliance_pauseAudio

四、示例代码(Demo)


<!DOCTYPE html>
<html lang="zh-CN">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>音频播放示例</title>
</head>

<body>
    <button id="playButton">播放音频</button>
    <button id="stopButton">停止音频</button>
    <button id="pauseButton">暂停音频</button>
    <button id="continueButton">继续音频</button>

    <script>
        // 假设   已经定义
        const audioUrl = 'your_audio_url.mp3';

        const playButton = document.getElementById('playButton');
        const stopButton = document.getElementById('stopButton');
        const pauseButton = document.getElementById('pauseButton');
        const continueButton = document.getElementById('continueButton');

        playButton.addEventListener('click', function () {
            $cq().未来之窗_语音交互_音频播放(audioUrl);
        });

        stopButton.addEventListener('click', function () {
            $cq().未来之窗_语音交互_音频停止();
        });

        pauseButton.addEventListener('click', function () {
            $cq().未来之窗_语音交互_音频暂停();
        });

        continueButton.addEventListener('click', function () {
            $cq().未来之窗_语音交互_音频继续();
        });
    </script>
</body>

</html>
    

五、注意事项

  • 请确保传入的音频 URL 是有效的,否则音频播放将失败。
  • 由于浏览器的自动播放限制,可能需要用户进行交互(如点击页面)后才能触发音频播放。
  • 当调用 fairyalliance_playAudio 时,如果已有音频正在播放,会先停止已有音频,避免多音频同时播放。

硬件app