> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/profiles-and-mappings.md).

# 配置文件和映射

唇形同步系统使用两种 ScriptableObject 类型来描述 blendshape 数据如何从 Convai 流向角色的网格： **配置文件** 是位于 **映射**。大多数设置都可使用捆绑的资源——只有当你的骨骼使用非标准的 blendshape 名称，或者使用内置配置文件未涵盖的传输格式时，才创建自定义资源。

### 什么是配置文件？

A **配置文件** 定义传输格式——它告诉 SDK 在来自 Convai 的数据流中应期待哪些 blendshape 通道名称。配置文件的 ID（例如， `arkit`, `metahuman`, `cc4extended`）就是你输入的 `ConvaiLipSyncComponent._lockedProfileId`.

**包含以下三个配置文件：**

| 配置文件资源                             | ID            | 格式                            |
| ---------------------------------- | ------------- | ----------------------------- |
| `ConvaiLipSyncProfile_ARKit`       | `arkit`       | 61 个标准 ARKit 通道               |
| `ConvaiLipSyncProfile_MetaHuman`   | `metahuman`   | 275+ 个 MetaHuman CTRL 表情      |
| `ConvaiLipSyncProfile_CC4Extended` | `cc4extended` | 240+ 个 Character Creator 4 通道 |

只有当你的角色使用 Convai 通过自定义 ID 传输的专有 blendshape 格式时，才创建自定义配置文件。实际上这很少见——大多数管线使用这三种内置格式之一。

### 什么是映射？

A **映射** 将源 blendshape 通道（来自配置文件）路由到角色上实际的 blendshape 名称 `SkinnedMeshRenderer`。它还允许你应用每个通道的乘数、偏移和限制。

**包含四个映射：**

| 映射资源                                         | 路由                            |
| -------------------------------------------- | ----------------------------- |
| `ConvaiLipSyncDefaultMap_ARKit`              | ARKit → ARKit（直通）             |
| `ConvaiLipSyncDefaultMap_MetaHuman`          | MetaHuman → MetaHuman（直通）     |
| `ConvaiLipSyncDefaultMap_CC4Extended`        | CC4Extended → CC4Extended（直通） |
| `ConvaiLipSyncDefaultMap_ARKitToCC4Extended` | ARKit → CC4Extended（转换）       |

当 `ConvaiLipSyncComponent._mapping` 留空时，SDK 会根据锁定的配置文件 ID 自动选择匹配的直通映射。

当角色的 blendshape 名称与预期名称不同，或者你需要调整权重乘数以匹配骨骼的校准时，创建自定义映射。

### 何时创建自定义资源

| 情况                              | 创建                            |
| ------------------------------- | ----------------------------- |
| 你的骨骼完全使用 ARKit/MetaHuman/CC4 名称 | 无需——使用捆绑的映射（保持 `_mapping` 为空） |
| 你的骨骼对标准 blendshape 使用不同的名称      | 自定义 **映射** 仅                  |
| 你接收到 ARKit 流，但你的骨骼使用 CC4 名称     | 使用捆绑的 `ARKitToCC4Extended` 映射 |
| 你的角色使用一整套完全自定义的 blendshape      | 自定义 **配置文件** + 自定义 **映射**     |

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>创建唇形同步配置文件</strong><br>为专有的 blendshape 集定义一个新的传输格式标识符。</td><td><a href="/pages/23f7f0807dc9d3c6490dd0b0704dfd8092cd998e">/pages/23f7f0807dc9d3c6490dd0b0704dfd8092cd998e</a></td></tr><tr><td><strong>创建自定义 blendshape 映射</strong><br>使用每通道调优，将流通道路由到骨骼实际的 blendshape 名称。</td><td><a href="/pages/0808b43e9ba988a5156bb5fb55261f1f67638b57">/pages/0808b43e9ba988a5156bb5fb55261f1f67638b57</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/profiles-and-mappings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.