---
title: "CozyBlanket 网络 | Sparseal"
url: "https://sparseal.com/zh-cn/cozyblanket/network/"
language: "zh-Hans"
description: "通过网络实用工具、Blender 和 ZBrush 集成以及 Python 模块，将 CozyBlanket 连接到桌面工具。"
---

# CozyBlanket 网络 API

了解 CozyBlanket 的网络功能如何协同运作，简化您的工作流程。

## CozyBlanket 网络功能

CozyBlanket 的远程网络功能可让桌面 DCC 软件、服务器和流程工具控制 CozyBlanket，从而与现有软件集成。

请确保已在 CozyBlanket 中启用网络功能。网络功能仅包含在 Standard 许可证中。

### 下载网络脚本

[cozyblanket\_network\_utils.zip](https://sparseal.com/cozyblanket/assets/cozyblanket_network_utils_2.0.1.zip)

#### 包内包含：

-   ✓ 带 CLI 的 Python 模块
-   ✓ Blender 插件（Windows、Mac、Linux）
-   ✓ ZBrush 插件（Windows） 实验性

## 软件集成

### 命令行界面

通过 CLI，您可以从终端或脚本快速操作 CozyBlanket。

`python cli.py --help # List all supported commands   python -m cozyblanket.cli --help # If installed via pip`

### Blender 插件

Blender 插件可在重拓扑工作流程中与 CozyBlanket 无缝集成。

需要 Blender 3.0 或更高版本。

#### 安装

前往 Edit > Preferences > Add-ons > Install，选择 cozyblanket\_remote\_blender.zip 文件以安装插件。

#### 功能

-   向 CozyBlanket 推送一个或多个目标对象
-   向 CozyBlanket 推送一个或多个目标对象及一个 EditMesh
-   将当前 CozyBlanket EditMesh 拉取到活动对象
-   将 EditMesh 和 CozyBlanket 摄像机位置实时同步到 Blender

插件操作可在 N Panel 中找到。

### ZBrush 插件（实验性）

实验性 ZBrush 插件可在雕刻工作流程中与 CozyBlanket 集成。

需要在 Windows 上运行 Maxon ZBrush 2022。

#### 安装

将提供的 ZBrush 文件夹中的内容复制到：C:/Program Files/Maxon/ZBrush2022/ZStartup/ZPlugs64。

#### 功能

-   将当前 SubTool 推送到 CozyBlanket
-   将 CozyBlanket EditMesh 拉取到当前 SubTool

这些工具位于 ZPlugins > CozyBlanket 菜单中。

## Python 模块集成

附带的 Python 模块提供了 CozyBlanket 网络 API 的参考实现，还包含在编写流程脚本时直接导入 .obj 文件的实用函数。

pip 安装命令： `pip install cozyblanket`

### 使用示例

```
from cozyblanket import CozyBlanketConnection

# Connect to a running instance
CB = CozyBlanketConnection()  # Optional device_id argument
CB.connect()

# Close current document and clear scene
CB.document_close()
CB.scene_clear()

# Push new retopology target from OBJ
CB.target_push_obj("target.obj", "named_target")
CB.target_load("named_target")

# Save current mesh to OBJ
CB.editmesh_pull_obj("editmesh.obj")

# Add remote action button
CB.remote_actions_add(
    "Example Button",
    lambda: print("The user pressed the button!")
)

# Process remote actions
while True:
    CB.remote_actions_process()

# Cleanup connection
CB.disconnect()
```

注意：客户端应用程序需要定期调用 `remote_actions_process()` 方法来处理传入事件。

![CozyBlanket 应用图标](https://sparseal.com/cozyblanket/assets/appicon.jpeg)

## CozyBlanket

重拓扑、UV 与烘焙

[![在 App Store 下载](https://sparseal.com/cozyblanket/assets/appstore.svg)](https://apps.apple.com/us/app/cozyblanket/id1608079174)

\*CozyBlanket 需要通过应用内购买激活。CozyBlanket 提供两个版本。请在 CozyBlanket 应用内查看当地价格。

## 结构化数据

```json
[
  {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "Organization",
        "@id": "https://sparseal.com/#organization",
        "name": "Sparseal",
        "legalName": "Sparseal SL",
        "url": "https://sparseal.com/",
        "description": "Sparseal 开发用于数字内容创作的 CGI 软件，涵盖雕刻、建模、纹理绘制、重拓扑、UV 展开和烘焙。",
        "logo": "https://sparseal.com/assets/favicon/android-chrome-512x512.webp",
        "sameAs": [
          "https://bsky.app/profile/sparseal.bsky.social",
          "https://discord.com/invite/7ZSxK7MAkM",
          "https://www.youtube.com/@sparseal3016",
          "https://x.com/sparseal"
        ],
        "contactPoint": [
          {
            "@type": "ContactPoint",
            "email": "support@sparseal.com",
            "contactType": "technical support"
          },
          {
            "@type": "ContactPoint",
            "email": "info@sparseal.com",
            "contactType": "general inquiries"
          }
        ]
      }
    ]
  }
]
```