> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio QR Code

> 创建一个可播放音频文件的 QR 码。

## 适用场景

音频页面在扫描时播放声音——一段叙述性故事、一份曲目列表、一条语音留言——通过专门的 **Audio Player** 区块实现，而不是通用的媒体嵌入。它是一个完整的 Page Builder 页面（而不是一个单独的、仅供上传的工具）：播放器只是 Page Builder 众多区块类型中的一种，因此您可以将其与其他区块组合使用，也可以从模板开始。

<Note>
  与本页其他类别一样，"Audio QR code" 是通过 **Build a Page** 流程、按 Audio 标签筛选后进入的——没有单独的上传并生成音频页面的路径。
</Note>

## 查找音频模板并进入编辑器

<Steps>
  <Step title="打开 Create QR Code 并选择 Build a Page">
    从 **QR Codes → Create QR Code**（`/qr/create`）进入，点击 **Build a Page** 卡片。
  </Step>

  <Step title="按 Audio 筛选画廊">
    在 **Choose a template**（`/qr/new`）页面，点击 **Audio** 标签。在验证时，恰好只有**一个**匹配的模板：**Short Story Narration**。

    <Frame caption="按 Audio 标签筛选后的模板画廊——只有一个可用模板">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/audio/gallery-filtered.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=0b5d9b69514b5bdfd1318baa56d85957" alt="按 Audio 标签筛选的模板画廊，只显示 Short Story Narration 模板以及 Start Blank 选项" width="1280" height="755" data-path="images/v2/qr-codes/create/audio/gallery-filtered.png" />
    </Frame>

    <Warning>
      在画廊中所有带标签的类别里，Audio 的模板选择是最少的——只有一个选项。如果 Short Story Narration 的暗色、文学风格不适合您的用例，可以从 **Start Blank** 开始，自行添加 **Audio Player** 区块；它是一个独立的一级区块类型，并不依赖于这个模板。
    </Warning>
  </Step>

  <Step title="预览并选择模板">
    点击卡片以打开其预览面板，然后点击 **Use this template**。
  </Step>

  <Step title="进入 Page Builder">
    选择后会打开 `/qr/new/landing?template=audio-short-stories` 处的编辑器。画布上展示了一个深色的、类似书本的移动端预览，列出两条音频曲目（"The Black Cat — Edgar Allan Poe" 和 "Markheim — Robert Louis Stevenson"），左侧区块面板中恰好列出一个区块：**Audio Player**。

    <Frame caption="打开 Short Story Narration 音频模板后的 Page Builder 画布">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/audio/builder-canvas.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=c67d601f1741c7d8e140cf078c7577ee" alt="Page Builder 画布，展示 Short Story Narration 音频模板，包含一个列出两个叙述故事的 Audio Player 区块" width="1280" height="720" data-path="images/v2/qr-codes/create/audio/builder-canvas.png" />
    </Frame>

    <Check>
      能够到达这个画布即可确认流程有效——无需发布即可验证。打开 **Audio Player** 区块上传您自己的曲目，准备好后从顶部栏使用 **Publish**。
    </Check>
  </Step>
</Steps>

## 通过 API 创建

若要通过 API 而非界面创建音频风格的 QR 码，请使用类别 ID `16`（标记为 **Audio**）——完整的请求结构请参见 [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)，完整的 ID 到标签映射请参见 [Category List](/v1/api-reference/references/category-list)。

## 相关内容

* [Page Builder 概览](/zh/page-builder/overview) —— 该模板会打开的、基于区块的编辑器，以及如何自行添加 Audio Player 区块。
* [Templates](/zh/page-builder/templates) —— 浏览画廊，以及从空白画布开始的另一种方式。
* [创建您的第一个 QR 码](/zh/getting-started/first-qr-code) —— 进入此类别所使用的通用 Create QR Code 流程。
* [文件夹、标签与批量操作](/zh/qr-codes/manage/folders-tags-bulk-operations) —— 发布后整理该 QR 码。