> 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` 类型来描述混合形状数据如何从 Convai 流向角色的网格： **配置文件** 和 **映射**。大多数设置都可使用随附资源——仅当你的骨骼使用非标准的混合形状名称，或使用内置配置文件未覆盖的传输格式时，才创建自定义资源。

### 什么是配置文件？

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

**随附了三个配置文件：**

| 配置文件资源                             | ID             | 格式                           |
| ---------------------------------- | -------------- | ---------------------------- |
| `ConvaiLipSyncProfile_ARKit`       | `arkit`        | 61 个标准 ARKit 通道              |
| `ConvaiLipSyncProfile_MetaHuman`   | `metahuman`    | 251 个 MetaHuman CTRL 表达      |
| `ConvaiLipSyncProfile_CC4Extended` | `cc4_extended` | 170 个 Character Creator 4 通道 |

仅当你的角色使用 Convai 通过自定义 ID 传输的专有混合形状格式时，才创建自定义配置文件。实际上这种情况很少见——大多数流程都使用这三种随附格式之一。

### 什么是映射？

A **映射** 将源混合形状通道（来自配置文件）路由到角色的实际混合形状名称 `SkinnedMeshRenderer`。它还允许你应用按通道的乘数、偏移和钳制。

**随附了四个映射：**

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

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

`ConvaiLipSyncMapAsset.Mappings` 将其条目公开为 `IReadOnlyList<BlendshapeMappingEntry>` ——运行时读取映射的代码不能添加、删除或重新排序条目。请在编辑器中创建映射；参见 [创建自定义唇形同步映射](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/create-a-custom-blendshape-map.md).

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

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

| 情况                              | 创建                            |
| ------------------------------- | ----------------------------- |
| 你的骨骼完全使用 ARKit/MetaHuman/CC4 名称 | 无需操作——使用随附映射（将 `_mapping` 留空） |
| 你的骨骼对标准混合形状使用不同的名称              | 自定义 **映射** 仅                  |
| 你收到的是 ARKit 流，但你的骨骼使用 CC4 名称    | 使用随附的 `ARKitToCC4Extended` 映射 |
| 你的角色使用完全自定义的混合形状集               | 自定义 **配置文件** ＋自定义 **映射**      |

### 下一步

{% content-ref url="/pages/23f7f0807dc9d3c6490dd0b0704dfd8092cd998e" %}
[创建口型同步配置文件](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/create-a-lip-sync-profile.md)
{% endcontent-ref %}

{% content-ref url="/pages/0808b43e9ba988a5156bb5fb55261f1f67638b57" %}
[创建自定义口型同步映射](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/add-lip-sync/create-a-custom-blendshape-map.md)
{% endcontent-ref %}


---

# 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.