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

# Click Track

> 生成节拍器咔哒声作为音频 —— 设定速度和拍号，或从标签构建咔哒点。

<Frame caption="Click Track · 截图待补">
  <img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/nodes/_placeholder.svg?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=b54171099e5b02d4313fe581171ebbcc" alt="Click Track" width="800" height="450" data-path="images/nodes/_placeholder.svg" />
</Frame>

## 这个节点做什么

**Click Track（节拍器）** 生成一条节拍器。给它一个速度、一个拍号和小节数，它就通过音乐车道
其余部分共用的那个 SoundFont 合成器渲染出一条咔哒音轨（强拍加重、弱拍平淡）。也可以接入一个
`labels` 文本输入，把咔哒声放在具体的、有标签的点上，而不是固定网格上。

按 **▶ Run** 在后端渲染。节点输出两样：`audio` 咔哒音轨，以及一个描述这些咔哒的 `performance`
负载 —— 与 **Score Synth** 等 stage 消费的演奏是同一种，因此这条咔哒也能兼作其它渲染的
时值参考。

## 什么时候用它

* 你需要一条节拍器音轨来录音或对齐。
* 你想要一个特定 BPM 与拍号下的预备拍或时值垫底。
* 你有时值标签，想把咔哒声精确放在那些点上。

## 参数

### bpm

速度，每分钟拍数，**20–400**（默认 **120**），步进 0.5。当由 `labels` 输入驱动咔哒时被忽略。

### beats\_per\_bar

每小节拍数（拍号的分子），**1–12**（默认 **4**）。每小节的第一拍被加重。

### bars

生成多少小节，**1–256**（默认 **8**）。

### soundfont

可选的资源库 SoundFont 文件名，用于给咔哒配音。留空（或找不到）时使用合成器内置的咔哒音色。

### labels（可选输入）

一个可选文本输入，类型 `COMFYTV_TEXT`。存在时，咔哒音轨由这些标签构建（咔哒落在有标签的
位置），而不是由 `bpm`/`beats_per_bar`/`bars` 决定。

## 输出

| 输出              | 类型              | 含义                  |
| --------------- | --------------- | ------------------- |
| **audio**       | `COMFYTV_AUDIO` | 渲染出的节拍器咔哒音轨         |
| **performance** | `COMFYTV_TEXT`  | 咔哒演奏（JSON），可复用为时值参考 |

## 提示

* 需要平直的网格咔哒时不接 `labels`；需要不规则、有标签的点上打咔哒时才接它。
* `performance` 输出可以喂给 **Score Synth**，或用来把其它 stage 对齐到同一网格。
* 只有在你想要特定咔哒音色时才加 SoundFont；默认开箱即用。

## 相关节点

* **Score Synth** —— 可渲染咔哒 `performance`，并与之共用合成器。
* **Score Performer** —— 以同样方式产出音乐演奏。
* **Bridge** —— 把 `COMFYTV_AUDIO` 与原生 ComfyUI 音频互转。见
  [https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)
