From 56271f9a96e3344e32d06c8168cecbbb1eb74d12 Mon Sep 17 00:00:00 2001 From: hoarfroster Date: Fri, 26 Jul 2024 20:41:11 +0800 Subject: [PATCH 1/2] chores: convert noteblocks --- .../api/url/createobjecturl_static/index.md | 6 ++- files/zh-cn/web/api/url/port/index.md | 3 +- .../api/url/revokeobjecturl_static/index.md | 3 +- .../web/api/urlsearchparams/tostring/index.md | 3 +- .../web/api/view_transitions_api/index.md | 3 +- files/zh-cn/web/api/visualviewport/index.md | 6 ++- .../web/api/waveshapernode/curve/index.md | 3 +- .../using_the_web_animations_api/index.md | 6 ++- .../index.md | 18 +++++--- files/zh-cn/web/api/web_audio_api/index.md | 6 ++- .../using_web_audio_api/index.md | 39 +++++++++++------ .../index.md | 12 ++++-- .../web_audio_spatialization_basics/index.md | 9 ++-- .../zh-cn/web/api/web_bluetooth_api/index.md | 3 +- .../using_templates_and_slots/index.md | 9 ++-- files/zh-cn/web/api/web_crypto_api/index.md | 3 +- files/zh-cn/web/api/web_nfc_api/index.md | 3 +- files/zh-cn/web/api/web_share_api/index.md | 6 ++- .../using_the_web_speech_api/index.md | 3 +- files/zh-cn/web/api/web_storage_api/index.md | 6 ++- .../using_the_web_storage_api/index.md | 9 ++-- .../index.md | 3 +- files/zh-cn/web/api/web_workers_api/index.md | 6 ++- .../transferable_objects/index.md | 6 ++- .../using_web_workers/index.md | 30 ++++++++----- .../web/api/webgl2renderingcontext/index.md | 3 +- .../uniformmatrix/index.md | 3 +- .../basic_2d_animation_example/index.md | 3 +- .../webgl_api/by_example/hello_glsl/index.md | 3 +- .../matrix_math_for_the_web/index.md | 3 +- .../index.md | 30 ++++++++----- .../animating_textures_in_webgl/index.md | 21 ++++++---- .../creating_3d_objects_using_webgl/index.md | 33 ++++++++++----- .../index.md | 18 +++++--- .../tutorial/using_textures_in_webgl/index.md | 42 ++++++++++++------- .../api/webgl_api/using_extensions/index.md | 3 +- .../webgl_model_view_projection/index.md | 9 ++-- .../zh-cn/web/api/webgl_lose_context/index.md | 3 +- .../enablevertexattribarray/index.md | 3 +- .../webglrenderingcontext/uniform/index.md | 3 +- files/zh-cn/web/api/webgpu_api/index.md | 15 ++++--- .../connect_peers/answer_a_call/index.md | 3 +- .../connect_peers/end_a_call/index.md | 6 ++- .../get_microphone_permission/index.md | 3 +- .../build_a_phone_with_peerjs/index.md | 3 +- .../web/api/webrtc_api/connectivity/index.md | 9 ++-- .../api/webrtc_api/session_lifetime/index.md | 6 ++- .../signaling_and_video_calling/index.md | 24 +++++++---- .../simple_rtcdatachannel_sample/index.md | 9 ++-- .../webrtc_api/using_data_channels/index.md | 6 ++- .../web/api/webrtc_api/using_dtmf/index.md | 6 ++- files/zh-cn/web/api/websocket/close/index.md | 3 +- files/zh-cn/web/api/websocket/send/index.md | 3 +- files/zh-cn/web/api/websockets_api/index.md | 3 +- .../index.md | 3 +- .../index.md | 6 ++- .../writing_websocket_server/index.md | 9 ++-- .../writing_websocket_servers/index.md | 39 +++++++++++------ .../zh-cn/web/api/webvr_api/concepts/index.md | 6 ++- files/zh-cn/web/api/webvr_api/index.md | 6 ++- .../webvr_api/using_the_webvr_api/index.md | 15 ++++--- files/zh-cn/web/api/webxr_device_api/index.md | 3 +- .../web/api/wgsllanguagefeatures/index.md | 3 +- files/zh-cn/web/api/wheelevent/index.md | 6 ++- .../web/api/window/clearimmediate/index.md | 3 +- files/zh-cn/web/api/window/console/index.md | 3 +- files/zh-cn/web/api/window/find/index.md | 3 +- .../web/api/window/frameelement/index.md | 3 +- .../web/api/window/getcomputedstyle/index.md | 3 +- .../zh-cn/web/api/window/innerheight/index.md | 3 +- .../zh-cn/web/api/window/load_event/index.md | 3 +- .../web/api/window/localstorage/index.md | 3 +- .../web/api/window/mozinnerscreenx/index.md | 3 +- .../web/api/window/online_event/index.md | 3 +- files/zh-cn/web/api/window/open/index.md | 9 ++-- .../web/api/window/popstate_event/index.md | 3 +- .../api/window/requestanimationframe/index.md | 6 ++- .../web/api/window/requestfilesystem/index.md | 3 +- .../api/window/requestidlecallback/index.md | 3 +- .../web/api/window/resize_event/index.md | 3 +- .../web/api/window/sessionstorage/index.md | 9 ++-- .../web/api/window/setimmediate/index.md | 3 +- .../web/api/window/showmodaldialog/index.md | 3 +- files/zh-cn/web/api/worker/index.md | 3 +- files/zh-cn/web/api/worker/worker/index.md | 6 ++- .../api/workernavigator/appcodename/index.md | 3 +- .../web/api/workernavigator/appname/index.md | 3 +- .../api/workernavigator/appversion/index.md | 3 +- .../writablestream/writablestream/index.md | 3 +- .../writablestreamdefaultwriter/index.md | 3 +- files/zh-cn/web/api/xmlhttprequest/index.md | 3 +- .../mozbackgroundrequest/index.md | 6 ++- .../web/api/xmlhttprequest/open/index.md | 6 ++- .../xmlhttprequest/overridemimetype/index.md | 3 +- .../api/xmlhttprequest/readystate/index.md | 3 +- .../readystatechange_event/index.md | 6 ++- .../api/xmlhttprequest/responsetype/index.md | 3 +- .../web/api/xmlhttprequest/send/index.md | 3 +- .../xmlhttprequest/setrequestheader/index.md | 3 +- .../web/api/xmlhttprequest/timeout/index.md | 3 +- .../xmlhttprequest/withcredentials/index.md | 6 ++- .../index.md | 3 +- .../index.md | 6 ++- .../using_formdata_objects/index.md | 9 ++-- .../using_xmlhttprequest/index.md | 30 ++++++++----- files/zh-cn/web/api/xmlserializer/index.md | 3 +- 106 files changed, 514 insertions(+), 257 deletions(-) diff --git a/files/zh-cn/web/api/url/createobjecturl_static/index.md b/files/zh-cn/web/api/url/createobjecturl_static/index.md index e2eea3b8290ae0..fcc6117f9fa9d8 100644 --- a/files/zh-cn/web/api/url/createobjecturl_static/index.md +++ b/files/zh-cn/web/api/url/createobjecturl_static/index.md @@ -13,7 +13,8 @@ URL 的生命周期与其创建时所在窗口的 {{domxref("document")}} 绑定 要释放对象 URL，请调用 {{domxref("URL.revokeObjectURL_static", "revokeObjectURL()")}}。 -> **备注：** 此特性在 [Service Worker](/zh-CN/docs/Web/API/Service_Worker_API) 中*不*可用，因为它有可能导致内存泄漏。 +> [!NOTE] +> 此特性在 [Service Worker](/zh-CN/docs/Web/API/Service_Worker_API) 中*不*可用，因为它有可能导致内存泄漏。 ## 语法 @@ -46,7 +47,8 @@ URL.createObjectURL(object) 在较早版本的媒体源规范中，需要为 {{domxref("MediaStream")}} 创建一个对象 URL 才能将流附加到 {{HTMLElement("video")}} 元素。这已不再必要，浏览器正在逐步取消对此的支持。 -> **警告：** 如果你还有依赖于 {{domxref("URL.createObjectURL_static", "createObjectURL()")}} 将流附加到媒体元素的代码，你需要更新代码并将 {{domxref("HTMLMediaElement.srcObject", "srcObject")}} 设置为 `MediaStream`。 +> [!WARNING] +> 如果你还有依赖于 {{domxref("URL.createObjectURL_static", "createObjectURL()")}} 将流附加到媒体元素的代码，你需要更新代码并将 {{domxref("HTMLMediaElement.srcObject", "srcObject")}} 设置为 `MediaStream`。 ## 规范 diff --git a/files/zh-cn/web/api/url/port/index.md b/files/zh-cn/web/api/url/port/index.md index 702345c1c99674..24c4185ae54a39 100644 --- a/files/zh-cn/web/api/url/port/index.md +++ b/files/zh-cn/web/api/url/port/index.md @@ -9,7 +9,8 @@ l10n: {{domxref("URL")}} 接口的 **`port`** 属性是一个表示 URL 端口号的字符串。 -> **备注：** 如果传递给 [`URL()`](/zh-CN/docs/Web/API/URL/URL) 构造函数的输入字符串不包含显式端口号（例如 `https://localhost`），或者包含的端口号是与输入字符串的协议部分对应的默认端口号（例如 `https://localhost:443`），那么在构造函数返回的 [`URL`](/zh-CN/docs/Web/API/URL) 对象中，端口属性的值将为空字符串：`''`。 +> [!NOTE] +> 如果传递给 [`URL()`](/zh-CN/docs/Web/API/URL/URL) 构造函数的输入字符串不包含显式端口号（例如 `https://localhost`），或者包含的端口号是与输入字符串的协议部分对应的默认端口号（例如 `https://localhost:443`），那么在构造函数返回的 [`URL`](/zh-CN/docs/Web/API/URL) 对象中，端口属性的值将为空字符串：`''`。 ## 值 diff --git a/files/zh-cn/web/api/url/revokeobjecturl_static/index.md b/files/zh-cn/web/api/url/revokeobjecturl_static/index.md index af055860cacf97..7d0f9b64c068c6 100644 --- a/files/zh-cn/web/api/url/revokeobjecturl_static/index.md +++ b/files/zh-cn/web/api/url/revokeobjecturl_static/index.md @@ -11,7 +11,8 @@ l10n: 当你完成对对象 URL 的使用后，请调用此方法，让浏览器知道无需再保持对文件的引用。 -> **备注：** 由于 {{domxref("Blob")}} 接口的生命周期问题及潜在的内存泄漏风险，此方法在 [Service Worker](/zh-CN/docs/Web/API/Service_Worker_API) 中*不*可用。 +> [!NOTE] +> 由于 {{domxref("Blob")}} 接口的生命周期问题及潜在的内存泄漏风险，此方法在 [Service Worker](/zh-CN/docs/Web/API/Service_Worker_API) 中*不*可用。 ## 语法 diff --git a/files/zh-cn/web/api/urlsearchparams/tostring/index.md b/files/zh-cn/web/api/urlsearchparams/tostring/index.md index bbc6331c97158d..0f34f6b94e720d 100644 --- a/files/zh-cn/web/api/urlsearchparams/tostring/index.md +++ b/files/zh-cn/web/api/urlsearchparams/tostring/index.md @@ -9,7 +9,8 @@ l10n: {{domxref("URLSearchParams")}} 接口的 **`toString()`** 方法返回适用于 URL 中的查询字符串。 -> **备注：** 方法返回不带问号的查询字符串。这与 [`Location.search`](/zh-CN/docs/Web/API/Location/search)、[`HTMLAnchorElement.search`](/zh-CN/docs/Web/API/HTMLAnchorElement/search) 和 [`URL.search`](/zh-CN/docs/Web/API/URL/search) 都不同，它们均带有问号。 +> [!NOTE] +> 方法返回不带问号的查询字符串。这与 [`Location.search`](/zh-CN/docs/Web/API/Location/search)、[`HTMLAnchorElement.search`](/zh-CN/docs/Web/API/HTMLAnchorElement/search) 和 [`URL.search`](/zh-CN/docs/Web/API/URL/search) 都不同，它们均带有问号。 ## 语法 diff --git a/files/zh-cn/web/api/view_transitions_api/index.md b/files/zh-cn/web/api/view_transitions_api/index.md index 710c2e61365407..ec021044c6a487 100644 --- a/files/zh-cn/web/api/view_transitions_api/index.md +++ b/files/zh-cn/web/api/view_transitions_api/index.md @@ -22,7 +22,8 @@ slug: Web/API/View_Transitions_API View Transitions API 提供了一种更简单的方法来处理必需的 DOM 更改和过渡动画。 -> **备注：** View Transitions API 目前不支持跨文档视图过渡，但这已计划在未来的规范版本中实现，并正在积极开发中。 +> [!NOTE] +> View Transitions API 目前不支持跨文档视图过渡，但这已计划在未来的规范版本中实现，并正在积极开发中。 ### 创建基本视图过渡 diff --git a/files/zh-cn/web/api/visualviewport/index.md b/files/zh-cn/web/api/visualviewport/index.md index 675c6b58c7c1ff..6d99cac484cf6a 100644 --- a/files/zh-cn/web/api/visualviewport/index.md +++ b/files/zh-cn/web/api/visualviewport/index.md @@ -9,7 +9,8 @@ slug: Web/API/VisualViewport 你可以使用 {{domxref("Window.visualViewport")}} 获得对应 window 的视觉视口 API。 -> **备注：** 与布局视口（layout viewport）不同的是：只有最上层的 window 才有视觉视口（visual viewport）这一概念。因此只有最上层 window 的 `VisualViewport` 属性才是有效的，其他层的视觉视口属性可看作是布局视口属性的别名。比如，对于一个 {{htmlelement("iframe")}} ，其对应的视觉视口属性 {{domxref("VisualViewport.width")}} 相当于对应的布局视口属性，如 {{domxref("Element.clientWidth", "document.documentElement.clientWidth")}}. +> [!NOTE] +> 与布局视口（layout viewport）不同的是：只有最上层的 window 才有视觉视口（visual viewport）这一概念。因此只有最上层 window 的 `VisualViewport` 属性才是有效的，其他层的视觉视口属性可看作是布局视口属性的别名。比如，对于一个 {{htmlelement("iframe")}} ，其对应的视觉视口属性 {{domxref("VisualViewport.width")}} 相当于对应的布局视口属性，如 {{domxref("Element.clientWidth", "document.documentElement.clientWidth")}}. ## 属性 @@ -93,7 +94,8 @@ window.visualViewport.addEventListener("scroll", viewportHandler); window.visualViewport.addEventListener("resize", viewportHandler); ``` -> **备注：** 应小心使用上述方案，使用这种方式模拟的 `position: device-fixed` 可能会导致其他元素在滚动页面时出现闪烁。 +> [!NOTE] +> 应小心使用上述方案，使用这种方式模拟的 `position: device-fixed` 可能会导致其他元素在滚动页面时出现闪烁。 ## 规范 diff --git a/files/zh-cn/web/api/waveshapernode/curve/index.md b/files/zh-cn/web/api/waveshapernode/curve/index.md index 60c01d7f819c57..a23501eb5fbc53 100644 --- a/files/zh-cn/web/api/waveshapernode/curve/index.md +++ b/files/zh-cn/web/api/waveshapernode/curve/index.md @@ -11,7 +11,8 @@ slug: Web/API/WaveShaperNode/curve 如有必要，使用线性插值计算畸变曲线的中间值。 -> **备注：** 数组的值可以是 `null` : 在这个情况下，不会有畸变被应用到输入的信号上。 +> [!NOTE] +> 数组的值可以是 `null` : 在这个情况下，不会有畸变被应用到输入的信号上。 ## 语法 diff --git a/files/zh-cn/web/api/web_animations_api/using_the_web_animations_api/index.md b/files/zh-cn/web/api/web_animations_api/using_the_web_animations_api/index.md index c61d06f2e8b251..4cfe85bc59dc19 100644 --- a/files/zh-cn/web/api/web_animations_api/using_the_web_animations_api/index.md +++ b/files/zh-cn/web/api/web_animations_api/using_the_web_animations_api/index.md @@ -91,7 +91,8 @@ var aliceTiming = { - 一个，持续时间是毫秒，而不是秒 - 3000 不是 3 秒.。像{{domxref("WindowTimers.setTimeout()")}} 和{{domxref("Window.requestAnimationFrame()")}}, Web 动画 API 只支持毫秒。 - The other thing you'll notice is that it's `iterations`, not `iteration-count`. -> **备注：** CSS 动画中使用的属性值与 Web 动画中使用的属性值存在一些小的差异。比如，Web 动画中不能使用字符串“infinite”，而是使用 Javascript 的关键字 Infinity。以及我们用 `easing` 来代替`timing-function`。我们不必在这列出`easing`的值，因为不像在 CSS 动画里，默认的"[animation-timing-function](/zh-CN/docs/Web/CSS/animation-timing-function)"是`ease`。页面动画 API 的默认 easing 是`linear`— 而这就是我们想要的。 +> [!NOTE] +> CSS 动画中使用的属性值与 Web 动画中使用的属性值存在一些小的差异。比如，Web 动画中不能使用字符串“infinite”，而是使用 Javascript 的关键字 Infinity。以及我们用 `easing` 来代替`timing-function`。我们不必在这列出`easing`的值，因为不像在 CSS 动画里，默认的"[animation-timing-function](/zh-CN/docs/Web/CSS/animation-timing-function)"是`ease`。页面动画 API 的默认 easing 是`linear`— 而这就是我们想要的。 #### 整合这些特性 @@ -359,7 +360,8 @@ aliceChange.onfinish = endGame; Prefer promises? The Web Animations API also specifies two promises: [`onfinish`](/zh-CN/docs/Web/API/Animation/onfinish) and [`oncancel`](/zh-CN/docs/Web/API/Animation/oncancel). -> **备注：** These promises are not fully supported as of this writing. +> [!NOTE] +> These promises are not fully supported as of this writing. ## 结论 diff --git a/files/zh-cn/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md b/files/zh-cn/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md index 4a256bdd2b27a1..a5e06ec82cf064 100644 --- a/files/zh-cn/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md +++ b/files/zh-cn/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md @@ -55,7 +55,8 @@ slug: Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API 当一个音频片段开始播放时，你将会听到最左侧的样本帧，之后是他右侧相邻的一帧，以此类推。在立体声中，你将会同时听到两个声道。样本帧的概念在此时非常有用，因为每个样本帧代表特定的播放时间，而和声道个数无关，这种方式很有利于精确的多声道同步处理。 -> **备注：** 只需用帧的数目除以采样率即可得到播放时间（单位为秒）。用样本点数目除以声道个数即可得到帧的数目。 +> [!NOTE] +> 只需用帧的数目除以采样率即可得到播放时间（单位为秒）。用样本点数目除以声道个数即可得到帧的数目。 下面我们将展示几个浅显易懂的示例： @@ -66,7 +67,8 @@ var buffer = context.createBuffer(2, 22050, 44100); 如果你使用上面的方法调用，你将会得到一个立体声（两个声道）的音频片段 (Buffer)，当它在一个频率为 44100 赫兹（这是目前大部分声卡处理声音的频率）的音频环境中播放的时候，会持续 0.5 秒：22050 帧 / 44100 赫兹 = 0.5 秒。 -> **备注：** 在[数字音频](https://zh.wikipedia.org/wiki/數位音訊)中，**44,100 [赫兹](https://zh.wikipedia.org/wiki/赫兹)**（有时也写作 **44.1 kHz**）是一个常见的[采样频率](https://zh.wikipedia.org/wiki/取樣)。为什么选取 44.1kHz 呢？首先，因为[人耳的接收频率](https://zh.wikipedia.org/wiki/聽力範圍)大约在 20 Hz 到 20,000 Hz 之间，根据[采样定理](https://zh.wikipedia.org/wiki/采样定理)，采样频率一定要大于最终生成数据最大频率的二倍，因此就一定要大于 40,000 Hz（即 40kHz）。不仅如此，在采样之前信号还必须通过[低通滤波器](https://zh.wikipedia.org/wiki/低通滤波器)，否则 会发生[混叠](https://zh.wikipedia.org/wiki/混疊)现象，一个理想低通滤波器会完全留下低于 20kHz 的信号（且没有使它衰减）并完美阻拦一切高于 20kHz 的信号，而事实上[过度频带](https://wikipedia.org/wiki/Transition_band)总是存在，在这个区域内信号会被部分衰减。这个频带越宽，建立一个[抗混叠滤波器](https://zh.wikipedia.org/wiki/抗混疊濾波器)才越容易。因此我们选取 44.1kHz 允许我们有 2.05kHz 的空间预留给过度频带。 +> [!NOTE] +> 在[数字音频](https://zh.wikipedia.org/wiki/數位音訊)中，**44,100 [赫兹](https://zh.wikipedia.org/wiki/赫兹)**（有时也写作 **44.1 kHz**）是一个常见的[采样频率](https://zh.wikipedia.org/wiki/取樣)。为什么选取 44.1kHz 呢？首先，因为[人耳的接收频率](https://zh.wikipedia.org/wiki/聽力範圍)大约在 20 Hz 到 20,000 Hz 之间，根据[采样定理](https://zh.wikipedia.org/wiki/采样定理)，采样频率一定要大于最终生成数据最大频率的二倍，因此就一定要大于 40,000 Hz（即 40kHz）。不仅如此，在采样之前信号还必须通过[低通滤波器](https://zh.wikipedia.org/wiki/低通滤波器)，否则 会发生[混叠](https://zh.wikipedia.org/wiki/混疊)现象，一个理想低通滤波器会完全留下低于 20kHz 的信号（且没有使它衰减）并完美阻拦一切高于 20kHz 的信号，而事实上[过度频带](https://wikipedia.org/wiki/Transition_band)总是存在，在这个区域内信号会被部分衰减。这个频带越宽，建立一个[抗混叠滤波器](https://zh.wikipedia.org/wiki/抗混疊濾波器)才越容易。因此我们选取 44.1kHz 允许我们有 2.05kHz 的空间预留给过度频带。 ```js var context = new AudioContext(); @@ -75,7 +77,8 @@ var buffer = context.createBuffer(1, 22050, 22050); 如果你这样调用，你将会得到一个单声道的音频片段 (Buffer)，当它在一个频率为 44100 赫兹的音频环境中播放的时候，将会被自动按照 44100 赫兹*重采样*（因此也会转化为 44100 赫兹的片段），并持续 1 秒：44100 帧 / 44100 赫兹 = 1 秒。 -> **备注：** 音频重采样与图片的缩放非常类似：比如你有一个 16 x 16 的图像，但是你想把它填充到一个 32 x 32 大小的区域，你就要对它进行缩放（重采样）。得到的结果会是一个较低品质的（图像会模糊或者有锯齿形的边缘，这取决于缩放采用的算法），但它却是能将原图形缩放，并且缩放后的图像占用空间比相同大小的普通图像要小。重新采样的音频道理相同——你会节约一些空间，但事实上你无法产出高频率的声音（高音区）。 +> [!NOTE] +> 音频重采样与图片的缩放非常类似：比如你有一个 16 x 16 的图像，但是你想把它填充到一个 32 x 32 大小的区域，你就要对它进行缩放（重采样）。得到的结果会是一个较低品质的（图像会模糊或者有锯齿形的边缘，这取决于缩放采用的算法），但它却是能将原图形缩放，并且缩放后的图像占用空间比相同大小的普通图像要小。重新采样的音频道理相同——你会节约一些空间，但事实上你无法产出高频率的声音（高音区）。 ### 分离式与交错式音频片段 @@ -107,7 +110,8 @@ LRLRLRLRLRLRLRLRLRLRLRLRLRLRLRLR（对于一个有 16 帧的音频片段） | _四声道_ | `0: L: 左 1: R: 右 2: SL: 环绕左 3: SR: 环绕右` | _Quad_ | `0: L: left 1: R: right 2: SL: surround left 3: SR: surround right` | | _5.1_ | `0: L: 左 1: R: 右 2: C: 中央 3: LFE: 低音炮 4: SL: 环绕左 5: SR: 环绕右` | _5.1_ | `0: L: left 1: R: right 2: C: center 3: LFE: subwoofer 4: SL: surround left 5: SR: surround right` | -> **备注：** 由于缩写来自英文，因此保留英文作对照。 +> [!NOTE] +> 由于缩写来自英文，因此保留英文作对照。 ### 向上和向下混频 @@ -335,7 +339,8 @@ LRLRLRLRLRLRLRLRLRLRLRLRLRLRLRLR（对于一个有 16 帧的音频片段） - {{domxref("AnalyserNode.getByteTimeDomainData()")}} - : 返回一个{{domxref("Uint8Array")}} 无符号字节数组 (unsigned byte array)，其中包含传递到此音频节点声音的实时波形，时间数据。 -> **备注：** 更多信息可以参考我们的这篇文章：[基于 Web Audio API 实现音频可视化效果](/zh-CN/docs/Web/API/Web_Audio_API/Visualizations_with_Web_Audio_API)。 +> [!NOTE] +> 更多信息可以参考我们的这篇文章：[基于 Web Audio API 实现音频可视化效果](/zh-CN/docs/Web/API/Web_Audio_API/Visualizations_with_Web_Audio_API)。 ## 空间位置化 @@ -349,7 +354,8 @@ LRLRLRLRLRLRLRLRLRLRLRLRLRLRLRLR（对于一个有 16 帧的音频片段） ![我们可以看到 AudioListener 的位置、向上和向前的向量（两者彼此成 90° 角）。](webaudiolistenerreduced.png) -> **备注：** 更多信息可以参考我们的这篇文章：[网络音频位置空间化入门](/zh-CN/docs/Web/API/Web_Audio_API/Web_audio_spatialization_basics)。 +> [!NOTE] +> 更多信息可以参考我们的这篇文章：[网络音频位置空间化入门](/zh-CN/docs/Web/API/Web_Audio_API/Web_audio_spatialization_basics)。 ## 扇入与扇出 diff --git a/files/zh-cn/web/api/web_audio_api/index.md b/files/zh-cn/web/api/web_audio_api/index.md index f1dbc8e1e37371..1c98107d050ba8 100644 --- a/files/zh-cn/web/api/web_audio_api/index.md +++ b/files/zh-cn/web/api/web_audio_api/index.md @@ -29,7 +29,8 @@ Web Audio API 使用户可以在**音频上下文**（AudioContext）中进行 Web Audio API 也使我们能够控制音频的*空间化*。在基于*源 - 侦听器模型*的系统中，它允许控制*平移模型*和处理*距离引起的衰减*或移动源（移动侦听）引起的*多普勒效应*。 -> **备注：** 你可以阅读我们关于 Web Audio API 的文章来了解更多细节 [Web Audio API 背后的基本概念](/zh-CN/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API)。 +> [!NOTE] +> 你可以阅读我们关于 Web Audio API 的文章来了解更多细节 [Web Audio API 背后的基本概念](/zh-CN/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API)。 ## Web Audio API 接口 @@ -122,7 +123,8 @@ Web Audio API 使用的音频源接口。 可以编写 JavaScript 代码来处理音频数据。当然，这需要用到下面的接口和事件。 -> **备注：** 这些功能在 Web Audio API 的 2014 年 8 月 9 日版本中已经标记为不推荐的，这些功能很快会被[Audio_Workers](#audio_workers)代替。 +> [!NOTE] +> 这些功能在 Web Audio API 的 2014 年 8 月 9 日版本中已经标记为不推荐的，这些功能很快会被[Audio_Workers](#audio_workers)代替。 - {{domxref("ScriptProcessorNode")}} - : **`ScriptProcessorNode`** 接口用于通过 JavaScript 代码生成，处理，分析音频。它是一个{{domxref("AudioNode")}}类型的音频处理模块，但是它与两个缓冲区相连接，一个缓冲区里包含当前的输入数据，另一个缓冲区里包含着输出数据。每当新的音频数据被放入输入缓冲区，就会产生一个{{domxref("AudioProcessingEvent")}}事件，当这个事件处理结束时，输出缓冲区里应该写好了新数据。 diff --git a/files/zh-cn/web/api/web_audio_api/using_web_audio_api/index.md b/files/zh-cn/web/api/web_audio_api/using_web_audio_api/index.md index cc9c371794a69f..f7928ac7fb19e6 100644 --- a/files/zh-cn/web/api/web_audio_api/using_web_audio_api/index.md +++ b/files/zh-cn/web/api/web_audio_api/using_web_audio_api/index.md @@ -46,7 +46,8 @@ const audioContext = new AudioContext(); 所以当我们这样做时会发生什么？为我们自动创建一个 {{domxref("BaseAudioContext")}} 并自动扩展到在线音频上下文。我们希望如此，因为我们想要播放在线声音。 -> **备注：** 如果你只是想处理音频数据，举个例子，缓存和流式传输而不播放它，你可能想要考虑创建一个 {{domxref("OfflineAudioContext")}}。 +> [!NOTE] +> 如果你只是想处理音频数据，举个例子，缓存和流式传输而不播放它，你可能想要考虑创建一个 {{domxref("OfflineAudioContext")}}。 ## 加载声音 @@ -56,7 +57,8 @@ const audioContext = new AudioContext(); ``` -> **备注：** 如果你要加载的声音文件保留在其他域中，则需要使用 `crossorigin` 属性；查看 [Cross Origin Resource Sharing (CORS)](/zh-CN/docs/Web/HTTP/CORS) 取得更多信息。 +> [!NOTE] +> 如果你要加载的声音文件保留在其他域中，则需要使用 `crossorigin` 属性；查看 [Cross Origin Resource Sharing (CORS)](/zh-CN/docs/Web/HTTP/CORS) 取得更多信息。 为了使用 Web Audio API 的优秀特性，我们需要从该元素中获取源并将其传入我们创建的上下文中。幸运的是，有一个方法可以让我们做到这一点 — {{domxref("AudioContext.createMediaElementSource")}}: @@ -68,7 +70,8 @@ const audioElement = document.querySelector("audio"); const track = audioContext.createMediaElementSource(audioElement); ``` -> **备注：** 上面的 `