8 API Web que vous ne connaissez peut-être pas mais qui sont très utiles

Dans l'API Web, il existe des objets, propriétés et fonctions très utiles qui peuvent être utilisés pour effectuer de petites tâches telles que l'accès au DOM, ou des tâches complexes telles que le traitement audio et vidéo. Les API courantes incluent Canvas, Web Worker, History, Fetch, etc. Jetons un coup d'œil à quelques API Web peu courantes mais utiles !

Présentation du texte intégral :

• API Web Audio

• API plein écran

• API Web Speech

• API Web Bluetooth

• API Vibration

• API du canal de diffusion

• API Clipboard

• API Web Share

1 API Web Audio

L'API audio nous permet d'exploiter des flux audio sur le Web, elle peut être utilisée pour ajouter des effets et des filtres aux sources audio sur le Web. Internet. La source audio peut provenir de <audio></audio>, d'un fichier source vidéo/audio ou d'un flux réseau audio. [Recommandations associées : tutoriel d'apprentissage Javascript]<audio></audio>、视频/音频源文件或音频网络流。【相关推荐：javascript学习教程】

下面来看一个例子：

    <header>
        <h2>Web APIs<h2>
    </h2>
</h2></header>
    <div>

        <div>
            <div>
                Demo - Audio
            </div>
            <div>
                <div></div>
                <div>
                    <audio></audio>
                </div>

                <div>
                    <button>Init</button>
                    <button>Play</button>
                    <button>Pause</button>
                    <button>Stop</button>
                </div>
                <div>

                    <span>Vol: <input></span>
                    <span>Pan: <input></span>
                </div>

            </div>
        </div>

    </div>


<script>
    const l = console.log
    let audioFromAudioFile = (function() {
        var audioContext
        var volNode
        var pannerNode
        var mediaSource

        function init() {
            l("Init")
        try {
                audioContext = new AudioContext()        
                mediaSource = audioContext.createMediaElementSource(audio)
                volNode = audioContext.createGain()
                volNode.gain.value = 1
                pannerNode = new StereoPannerNode(audioContext, { pan:0 })

                mediaSource.connect(volNode).connect(pannerNode).connect(audioContext.destination)
            }
            catch(e) {
                error.innerHTML = "此设备不支持 Web Audio API"
                error.classList.remove("close")
            }
        }

        function play() {
            audio.play()            
        }

        function pause() {
            audio.pause()
        }

        function stop() {
            audio.stop()            
        }

        function changeVolume() {
            volNode.gain.value = this.value
            l("Vol Range:",this.value)
        }

        function changePan() {
            pannerNode.gain.value = this.value
            l("Pan Range:",this.value)
        }

        return {
            init,
            play,
            pause,
            stop,
            changePan,
            changeVolume
        }
    })()
</script>

这个例子中将音频从 <audio></audio> 元素传输到 AudioContext，声音效果（如平移）在被输出到音频输出（扬声器）之前被添加到音频源。

按钮 Init 在单击时调用 init 函数。 这将创建一个 AudioContext 实例并将其设置为 audioContext。 接下来，它创建一个媒体源 createMediaElementSource(audio)，将音频元素作为音频源传递。音量节点 volNode 由 createGain 创建，可以用来调节音量。接下来使用 StereoPannerNode 设置平移效果，最后将节点连接至媒体源。

点击按钮（Play、Pause、Stop）可以播放、暂停和停止音频。页面有一个音量和平移的范围滑块，滑动滑块就可以调节音频的音量和平移效果。

相关资源：

• Demo：web-api-examples.github.io/audio.html
• MDN 文档：developer.mozilla.org/zh-CN/docs/…

2. Fullscreen API

Fullscreen API 用于在 Web 应用程序中开启全屏模式，使用它就可以在全屏模式下查看页面/元素。在安卓手机中，它会溢出浏览器窗口和安卓顶部的状态栏（显示网络状态、电池状态等的地方）。

Fullscreen API 方法：

• requestFullscreen：系统上以全屏模式显示所选元素，会关闭其他应用程序以及浏览器和系统 UI 元素。
• exitFullscreen：退出全屏模式并切换到正常模式。

下面来看一个常见的例子，使用全屏模式观看视频：：

    <header>
        <h2>Web APIs<h2>
    </h2>
</h2></header>
    <div>
        <div>
        <div>
            Demo - Fullscreen
        </div>
        <div>
        <div></div>
        <div>
            This API makes fullscreen-mode of our webpage possible. It lets you select the Element you want to view in fullscreen-mode, then it shuts off the browsers window features like URL bar, the window pane, and presents the Element to take the entire width and height of the system.

In Android phones, it will remove the browsers window and the Android UI where the network status, battery status are displayed, and display the Element in full width of the Android system.
        </div>
        <div>
            <video></video>
            <button>Toogle Fullscreen</button>
        </div>
        <div>
            This API makes fullscreen-mode of our webpage possible. It lets you select the Element you want to view in fullscreen-mode, then it shuts off the browsers window features like URL bar, the window pane, and presents the Element to take the entire width and height of the system.

In Android phones, it will remove the browsers window and the Android UI where the network status, battery status are displayed, and display the Element in full width of the Android system.
        </div>
        </div>
        </div>
    </div>


<script>
    const l =console.log

    function toggle() {
        const videoStageEl = document.querySelector(".video-stage")
        if(videoStageEl.requestFullscreen) {
            if(!document.fullscreenElement){
                videoStageEl.requestFullscreen()
            }
            else {
                document.exitFullscreen()
            }
        } else {
            error.innerHTML = "此设备不支持 Fullscreen API"
            error.classList.remove("close")        
        }
    }
</script>

可以看到，video 元素在 div#video-stage 元素中，带有一个按钮 Toggle Fullscreen。

当点击按钮切换全屏时，我们想让元素 div#video-stage 全屏显示。toggle 函数的实现如下：

function toggle() {
  const videoStageEl = document.querySelector(".video-stage")
  if(!document.fullscreenElement)
    videoStageEl.requestFullscreen()
  else
    document.exitFullscreen()
}

这里通过 querySelector 查找 div#video-stage 元素并将其 HTMLDivElement 实例保存在 videoStageEl 上。

然后，使用 document.fullsreenElement 属性来确定 document 是否是全屏的，所以可以在 videoStageEl 上调用 requestFullscreen()。 这将使 div#video-stage 占据整个设备的视图。

如果在全屏模式下点击 Toggle Fullscreen 按钮，就会在 document 上调用 exitFullcreen

Regardons un exemple :

    <header>
        <h2>Web APIs<h2>
    </h2>
</h2></header>
    <div>
        <div></div>

        <div>
            <div>
                Demo - Text to Speech
            </div>
            <div>
                <div>
                    <input>
                </div>

                <div>
                    <button>Tap to Speak</button>
                </div>
            </div>
        </div>

        <div>
            <div>
                Demo - Speech to Text
            </div>
            <div>
                <div>
                    <textarea></textarea>
                </div>

                <div>
                    <button>Tap and Speak into Mic</button>
                </div>
            </div>
        </div>

    </div>


<script>

    try {
        var speech = new SpeechSynthesisUtterance()
        var SpeechRecognition = SpeechRecognition;
        var recognition = new SpeechRecognition()

    } catch(e) {
        error.innerHTML = "此设备不支持 Web Speech API"
        error.classList.remove("close")                
    }

    function speak() {
        speech.text = textToSpeech.value
        speech.volume = 1
        speech.rate=1
        speech.pitch=1
        window.speechSynthesis.speak(speech)
    }

    function tapToSpeak() {
        recognition.onstart = function() { }

        recognition.onresult = function(event) {
            const curr = event.resultIndex
            const transcript = event.results[curr][0].transcript
            speechToText.value = transcript
        }

        recognition.onerror = function(ev) {
            console.error(ev)
        }

        recognition.start()
    }
</script>

Cet exemple transfère l'audio de l'élément <audio></audio> vers le AudioContext. Les effets sonores (tels que le panoramique) sont ajoutés à la sortie audio avant d'être émis vers l'audio. sortie (haut-parleur).

Button Init appelle la fonction init lorsqu'on clique dessus. Cela crée une instance AudioContext et la définit sur audioContext. Ensuite, il crée une source multimédia createMediaElementSource(audio), en passant l'élément audio comme source audio. Le nœud de volume volNode est créé par createGain et peut être utilisé pour régler le volume. Utilisez ensuite StereoPannerNode pour configurer l'effet de panoramique, et enfin connectez le nœud à la source multimédia.

🎜Cliquez Les boutons (Lecture, Pause, Arrêt) jouent, mettent en pause et arrêtent l'audio. La page comporte un curseur de volume et de plage panoramique, et vous pouvez régler le volume audio et l'effet panoramique en faisant glisser le curseur. 🎜🎜🎜Ressources associées : 🎜🎜

🎜🎜Démo : 🎜web-api-examples.github.io/audio.html🎜🎜🎜Documentation MDN : 🎜developer.mozilla.org/zh-CN/docs/…🎜🎜

2. API plein écran🎜🎜L'API plein écran est utilisée pour activer le mode plein écran dans les applications Web. Utilisez-la pour afficher des pages/éléments en mode plein écran. Sur les téléphones Android, il déborde de la fenêtre du navigateur et de la barre d'état en haut d'Android (où sont affichés l'état du réseau, l'état de la batterie, etc.). 🎜🎜Méthodes API plein écran : 🎜

🎜requestFullscreen : affiche l'élément sélectionné en mode plein écran sur le système, fermant les autres applications ainsi que les éléments du navigateur et de l'interface utilisateur du système. 🎜🎜exitFullscreen : Quittez le mode plein écran et passez en mode normal. 🎜🎜🎜Regardons un exemple courant de visionnage d'une vidéo en mode plein écran : 🎜

function speak() {
  const speech = new SpeechSynthesisUtterance()
  speech.text = textToSpeech.value
  speech.volume = 1
  speech.rate = 1
  speech.pitch = 1
  window.speechSynthesis.speak(speech)
}

🎜Comme vous pouvez le voir, l'élément vidéo se trouve dans l'élément div#video-stage, avec un bouton Basculer vers le plein écran. 🎜🎜🎜🎜Dang En cliquant sur le bouton pour passer en plein écran, nous souhaitons que l'élément div#video-stage s'affiche en plein écran. L'implémentation de la fonction toggle est la suivante : 🎜

function tapToSpeak() {
  var SpeechRecognition = SpeechRecognition;
  const recognition = new SpeechRecognition()
  recognition.onstart = function() { }
  recognition.onresult = function(event) {
    const curr = event.resultIndex
    const transcript = event.results[curr][0].transcript
    speechToText.value = transcript
  }
  recognition.onerror = function(ev) {
    console.error(ev)
  }
  recognition.start()
}

🎜Ici, nous utilisons querySelector pour trouver l'élément div#video-stage et enregistrer son instance HTMLDivElement dans videoStageEl. 🎜🎜Ensuite, utilisez la propriété document.fullsreenElement pour déterminer si le document est en plein écran, afin que vous puissiez appeler requestFullscreen() sur <code>videoStageEl code> . Cela fera que div#video-stage occupera toute la vue de l'appareil. 🎜🎜Si vous cliquez sur le bouton Basculer vers le plein écran en mode plein écran, exitFullscreen sera appelé sur le document, afin que la vue de l'interface utilisateur revienne à la vue normale (quitte le plein écran) . 🎜🎜🎜🎜🎜🎜Ressources associées : 🎜🎜

• Demo：web-api-examples.github.io/fullscreen.…
• MDN 文档：developer.mozilla.org/zh-CN/docs/…

3. Web Speech API

Web Speech API 提供了将语音合成和语音识别添加到 Web 应用程序的功能。使用此 API，我们将能够向 Web 应用程序发出语音命令，就像在 Android 上通过其 Google Speech 或在 Windows 中使用 Cortana 一样。

下面来看一个简单的例子，使用 Web Speech API 实现文字转语音和语音转文字：

    <header>
        <h2>Web APIs<h2>
    </h2>
</h2></header>
    <div>
        <div></div>

        <div>
            <div>
                Demo - Text to Speech
            </div>
            <div>
                <div>
                    <input>
                </div>

                <div>
                    <button>Tap to Speak</button>
                </div>
            </div>
        </div>

        <div>
            <div>
                Demo - Speech to Text
            </div>
            <div>
                <div>
                    <textarea></textarea>
                </div>

                <div>
                    <button>Tap and Speak into Mic</button>
                </div>
            </div>
        </div>

    </div>


<script>

    try {
        var speech = new SpeechSynthesisUtterance()
        var SpeechRecognition = SpeechRecognition;
        var recognition = new SpeechRecognition()

    } catch(e) {
        error.innerHTML = "此设备不支持 Web Speech API"
        error.classList.remove("close")                
    }

    function speak() {
        speech.text = textToSpeech.value
        speech.volume = 1
        speech.rate=1
        speech.pitch=1
        window.speechSynthesis.speak(speech)
    }

    function tapToSpeak() {
        recognition.onstart = function() { }

        recognition.onresult = function(event) {
            const curr = event.resultIndex
            const transcript = event.results[curr][0].transcript
            speechToText.value = transcript
        }

        recognition.onerror = function(ev) {
            console.error(ev)
        }

        recognition.start()
    }
</script>



第一个演示 Demo - Text to Speech 演示了使用这个 API 和一个简单的输入字段，接收输入文本和一个按钮来执行语音操作。

function speak() {
  const speech = new SpeechSynthesisUtterance()
  speech.text = textToSpeech.value
  speech.volume = 1
  speech.rate = 1
  speech.pitch = 1
  window.speechSynthesis.speak(speech)
}

它实例化了 SpeechSynthesisUtterance() 对象，将文本设置为从输入框中输入的文本中朗读。 然后，使用 speech 对象调用 SpeechSynthesis#speak 函数，在扬声器中说出输入框中的文本。

第二个演示 Demo - Speech to Text 将语音识别为文字。 点击 Tap and Speak into Mic 按钮并对着麦克风说话，我们说的话会被翻译成文本输入框中的内容。

点击 Tap and Speak into Mic 按钮会调用 tapToSpeak 函数：

function tapToSpeak() {
  var SpeechRecognition = SpeechRecognition;
  const recognition = new SpeechRecognition()
  recognition.onstart = function() { }
  recognition.onresult = function(event) {
    const curr = event.resultIndex
    const transcript = event.results[curr][0].transcript
    speechToText.value = transcript
  }
  recognition.onerror = function(ev) {
    console.error(ev)
  }
  recognition.start()
}

这里实例化了 SpeechRecognition，然后注册事件处理程序和回调。语音识别开始时调用 onstart，发生错误时调用 onerror。 每当语音识别捕获一条线时，就会调用 onresult。

在 onresult 回调中，提取内容并将它们设置到 textarea 中。 因此，当我们对着麦克风说话时，文字会出现在 textarea 内容中。

相关资源：

• Demo：web-api-examples.github.io/speech.html
• MDN 文档：developer.mozilla.org/zh-CN/docs/…

4. Web Bluetooth API

Bluetooth API 让我们可以访问手机上的低功耗蓝牙设备，并使用它将网页上的数据共享到另一台设备。

基本 API 是 navigator.bluetooth.requestDevice。 调用它将使浏览器提示用户使用设备选择器，用户可以在其中选择一个设备或取消请求。navigator.bluetooth.requestDevice 需要一个强制对象。 此对象定义过滤器，用于返回与过滤器匹配的蓝牙设备。

下面来看一个简单的例子，使用 navigator.bluetooth.requestDevice API 从 BLE 设备检索基本设备信息：

  <header>
    <h2>Web APIs<h2>
      </h2>
</h2></header>
      <div>
        
        <div>
          <div>
            Demo - Bluetooth
          </div>
          <div>
            <div></div>
            <div>
              <div>Device Name: <span></span>
</div>
              <div>Device ID: <span></span>
</div>
              <div>Device Connected: <span></span>
</div>
            </div>
            
            <div>
              <button>Get BLE Device</button>
            </div>
            
          </div>
        </div>
        
      </div>
      
    
    <script>
      function bluetoothAction(){
        if(navigator.bluetooth) {
          navigator.bluetooth.requestDevice({
            acceptAllDevices: true
          }).then(device => {            
            dname.innerHTML = device.name
            did.innerHTML = device.id
            dconnected.innerHTML = device.connected
          }).catch(err => {
            error.innerHTML = "Oh my!! Something went wrong."
            error.classList.remove("close")
          })
        } else {
          error.innerHTML = "Bluetooth is not supported."            
          error.classList.remove("close")
        }
      }
</script>



这里会显示设备信息。 单击 Get BLE Device 按钮会调用 bluetoothAction 函数：

function bluetoothAction(){
  navigator.bluetooth.requestDevice({
    acceptAllDevices: true
  }).then(device => {            
    dname.innerHTML = device.name
    did.innerHTML = device.id
    dconnected.innerHTML = device.connected
  }).catch(err => {
    console.error("Oh my!! Something went wrong.")
  })
}

bluetoothAction 函数调用带有 acceptAllDevices：true 选项的 navigator.bluetooth.requestDevice API，这将使其扫描并列出所有附近的蓝牙活动设备。 它返回了一个 promise，所以将它解析为从回调函数中获取一个参数 device，这个 device 参数将保存列出的蓝牙设备的信息。这是我们使用其属性在设备上显示信息的地方。

相关资源：

• Demo：web-api-examples.github.io/bluetooth.h…
• MDN 文档：developer.mozilla.org/en-US/docs/…

5. Vibration API

Vibration API 可以使我们的设备振动，作为对我们应该响应的新数据或信息的通知或物理反馈的一种方式。

执行振动的方法是 navigator.vibrate(pattern)。pattern 是描述振动模式的单个数字或数字数组。

这将使设备振动在 200 毫秒之后停止：

navigator.vibrate(200)
navigator.vibrate([200])

这将使设备先振动 200 毫秒，再暂停 300 毫秒，最后振动 400 毫秒并停止：

navigator.vibrate([200, 300, 400])

可以通过传递 0、[]、[0,0,0] 来消除振动。

下面来看一个简单的例子：

  <header>
    <h2>Web APIs<h2>
  </h2>
</h2></header>
  <div>
    <div>
      <div>
        Demo - Vibration
      </div>
      <div>
        <div></div>
        <div>
          <input>
        </div>
        <div>
          <button>Vibrate</button>
        </div>
      </div>
    </div>
  </div>

    
<script>
      if(navigator.vibrate) {
        function vibrate() {
          const time = vibTime.value
          if(time != "")
            navigator.vibrate(time)
        }
      } else {
        error.innerHTML = "Vibrate API not supported in this device."
        error.classList.remove("close")        
      }
</script>

这里有一个输入框和一个按钮。 在输入框中输入振动的持续时间并按下按钮。我们的设备将在输入的时间内振动。



相关资源：

• Demo：web-api-examples.github.io/vibration.h…
• MDN 文档：developer.mozilla.org/zh-CN/docs/…

6. Broadcast Channel API

Broadcast Channel API 允许从同源的不同浏览上下文进行消息或数据的通信。其中，浏览上下文指的是窗口、选项卡、iframe、worker 等。

BroadcastChannel 类用于创建或加入频道：

const politicsChannel = new BroadcastChannel("politics")

politics 是频道的名称，任何使用 politics 始化 BroadcastChannel 构造函数的上下文都将加入 politics 频道，它将接收在频道上发送的任何消息，并可以将消息发送到频道中。

如果它是第一个具有 politics 的 BroadcastChannel 构造函数，则将创建该频道。可以使用 BroadcastChannel.postMessage API 来将消息发布到频道。使用 BroadcastChannel.onmessage API 要订阅频道消息。

下面来看一个简单的聊天应用：

  <header>
    <h2>Web APIs<h2>
   </h2>
</h2></header>
   <div>
       <div>
          <div>
            Demo - BroadcastChannel
          </div>
          <div>
            <div>Open this page in another <i>tab</i>, <i>window</i> or <i>iframe</i> to chat with them.</div>
            <div></div>
            <div>
            </div>
            <div>
              <input>
              <button>Send Msg to Channel</button>
            </div>
          </div>
        </div> 
    </div>

<script>
      const l = console.log;
      try {
        var politicsChannel = new BroadcastChannel("politics")
        politicsChannel.onmessage = onMessage
        var userId = Date.now()
        } catch(e) {
          error.innerHTML = "BroadcastChannel API not supported in this device."
          error.classList.remove("close")
        }
      
      input.addEventListener("keydown", (e) => {
        if(e.keyCode === 13 && e.target.value.trim().length > 0) {
          sendMsg()            
        }
      })
      
      function onMessage(e) {     
        const {msg,id}=e.data   
        const newHTML = "<div class=&#39;chat-msg&#39;><span><i>"+id+": "+msg+""
        displayMsg.innerHTML = displayMsg.innerHTML + newHTML
        displayMsg.scrollTop = displayMsg.scrollHeight
      }
      
      function sendMsg() {
        politicsChannel.postMessage({msg:input.value,id:userId})
        
        const newHTML = "<div class=&#39;chat-msg&#39;><span><i>Me: "+input.value+""
        displayMsg.innerHTML = displayMsg.innerHTML + newHTML
        
        input.value = ""
        
        displayMsg.scrollTop = displayMsg.scrollHeight
      }   
</script>

这里有一个简单的文本和按钮。 输入消息，然后按按钮发送消息。下面初始化了politicalChannel，并在 politicalChannel 上设置了一个 onmessage 事件监听器，这样它就可以接收和显示消息。



点击按钮就会调用sendMsg 函数。 它通过 BroadcastChannel#postMessage API 将消息发送到 politics 频道。任何初始化此脚本的选项卡、iframe 或工作程序都将接收从此处发送的消息，因此此页面将接收从其他上下文发送的消息。相关资源：

• Demo：web-api-examples.github.io/broadcastch…
• MDN 文档：developer.mozilla.org/zh-CN/docs/…

7. Clipboard API

复制、剪切和粘贴等剪贴板操作是应用程序中最常见的一些功能。 Clipboard API 使 Web 用户能够访问系统剪贴板并执行基本的剪贴板操作。

以前，可以使用 document.execCommand 与系统剪贴板进行交互。 现代异步剪贴板 API 提供了直接读取和写入剪贴板内容的访问权限。

从剪贴板读取内容：

navigator.clipboard.readText().then(clipText =>
  document.getElementById("outbox").innerText = clipText
);

将内容写入剪贴板：

function updateClipboard(newClip) {
  navigator.clipboard.writeText(newClip).then(function() {
    /* clipboard successfully set */
  }, function() {
    /* clipboard write failed */
  });
}

相关资源：

• MDN 文档：developer.mozilla.org/zh-CN/docs/…

8. Web Share API

Share API 可帮助我们在 web 应用上实现共享功能。它给人以移动原生共享的感觉。它使共享文本、文件和指向设备上其他应用程序的链接成为可能。

可通过 navigator.share 方法访问 Web Share API：

if (navigator.share) {
  navigator.share({
    title: '百度',
    text: '百度一下',
    url: '<https:></https:>',
  })
    .then(() => console.log('分享成功'))
    .catch((error) => console.log('分享失败', error));
}

上面的代码使用原生 JavaScript 实现了文本共享。需要注意，我们只能使用 onclick 事件调用此操作：

function Share({ label, text, title }) {
  const shareDetails = { title, text };

  const handleSharing = async () => {
    if (navigator.share) {
      try {
        await navigator.share(shareDetails).then(() => console.log("Sent"));
      } catch (error) {
        console.log(`Oops! I couldn't share to the world because: ${error}`);
      }
    } else {
      // fallback code
      console.log(
        "Web share is currently not supported on this browser. Please provide a callback"
      );
    }
  };
  return (
    <button>
      <span>{label}</span>
    </button>
  );
}

相关资源：

• MDN 文档：developer.mozilla.org/en-US/docs/…

更多编程相关知识，请访问：编程视频！！

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!