SkillHub

vc-master-guide

v1.0.1

系统学习Visual Components 5.0，掌握Python编程、机器人离线编程、虚拟调试及高级工艺建模与连接通信技能。

Sourced from ClawHub, Authored by Robot_Qu

Installation

Please help me install the skill `vc-master-guide` from SkillHub official store. npx skills add qujingyang28/vc-master-guide

Visual Components 大师指南 ⭐⭐⭐⭐⭐

版本： v1.0
创建日期： 2026-03-13
目标： 让你彻底搞懂 Visual Components 5.0
适用人群： 新手入门 → 高级应用

🎯 技能概述

这是 Visual Components 的综合性学习技能，整合了：

  1. ✅ Python 3 API 完整解读 - 编程自动化
  2. ✅ 论坛精华帖整理 - 实战经验
  3. ✅ 完整使用说明书 - 系统学习
  4. ✅ 官方文档核对 - 准确权威

学完这个技能，你将： - 全面掌握 VC 5.0 所有功能 - 能够使用 Python 3 编写自动化脚本 - 了解行业最佳实践和实战技巧 - 避免常见错误和坑点

📖 学习路径

阶段 1：基础入门（1-2 周）⭐⭐

目标： 熟悉软件界面和基本操作

学习内容： 1. 软件安装与配置 2. 界面布局与操作 3. 从 eCatalog 添加组件 4. 创建第一个布局 5. 基础仿真

推荐资源： - 完整说明书 - 第 1-3 章 - 官方入门教程

实战练习： - 安装 VC 5.0 - 创建一个简单的传送带布局 - 运行仿真并观察

阶段 2：工艺建模（2-3 周）⭐⭐⭐

目标： 掌握工艺逻辑和物料流

学习内容： 1. 工艺语句（TransportIn/Out、Process、Wait） 2. 产品定义和生成 3. 信号和触发器 4. Python Statement 自定义逻辑 5. 仿真数据分析

推荐资源： - 完整说明书 - 第 8 章 - 论坛精华：不同工件加工时间设置

实战练习： - 创建一个带分拣的传送带系统 - 实现不同工件不同加工时间 - 使用 Python Statement 添加自定义逻辑

示例代码：

import vcCore as vc

async def OnRun():
    comp = vc.getComponent()
    conveyor = comp.findBehavior("Conveyor")
    sensor = comp.findBehavior("PartSensor")

    conveyor.Value = True

    while True:
        await sensor.OnSignal.wait()

        if sensor.Value:
            conveyor.Value = False
            await vc.delay(5.0)  # 加工 5 秒
            conveyor.Value = True

阶段 3：机器人编程（3-4 周）⭐⭐⭐⭐⭐

目标： 掌握机器人离线编程（OLP）

学习内容： 1. 机器人导入和配置 2. TCP 和工件坐标系 3. 路径规划 4. 自动路径求解器（5.0 新功能） 5. 基于模型的工程（MBE） 6. 后处理器和代码导出

推荐资源： - 完整说明书 - 第 9 章 - Python 3 API 详解 - 官方 OLP 教程

实战练习： - 导入机器人并配置 TCP - 创建码垛路径 - 使用自动路径求解器 - 导出程序到虚拟控制器

支持的后处理器品牌（22 个官方）：

ABB | CLOOS | Comau | Denso | Doosan | FANUC
Hyundai Robotics | IGM | Kawasaki | KUKA | Mitsubishi MELFA
Nachi | OMRON | OTC Daihen | Panasonic | Reis Robotics
Siasun | Stäubli | Techman | Universal Robots | Yamaha | Yaskawa

阶段 4：连接与通信（2-3 周）⭐⭐⭐⭐⭐

目标： 掌握虚拟调试和数字孪生

学习内容： 1. OPC UA 连接 2. MQTT 接口（5.0 新功能） 3. PLC 连接（Siemens、Rockwell 等） 4. 机器人连接（22 个品牌） 5. 虚拟调试流程

推荐资源： - 完整说明书 - 第 6 章 - 官方 Connectivity 文档

实战练习： - 配置 OPC UA 连接 - 连接虚拟 PLC - 实现虚拟调试 - 使用 MQTT 进行数据同步

阶段 5：Python 3 API 编程（4-6 周）⭐⭐⭐⭐⭐

目标： 掌握 Python 3 自动化编程

学习内容： 1. Python 3 基础语法 2. vcCore 模块（核心） 3. vcBehaviors 模块（信号处理） 4. vcRobotics 模块（机器人控制） 5. 异步编程（async/await） 6. 外部库集成（NumPy、pandas）

推荐资源： - Python 3 API 完整解读 - 官方 Python 3 API 文档 - 论坛精华：Python 脚本入门

实战练习： - 编写传送带控制脚本 - 实现多信号条件等待 - 创建自定义 vcCommand - 使用 pandas 分析仿真数据

核心方法速查：

方法 功能 使用频率
getApplication() 获取应用对象 ⭐⭐⭐⭐⭐
getComponent() 获取组件对象 ⭐⭐⭐⭐⭐
delay(seconds) 延时等待 ⭐⭐⭐⭐⭐
condition(func) 条件等待 ⭐⭐⭐⭐⭐
allTasks(tasks) 等待所有任务 ⭐⭐⭐⭐
anyTask(tasks) 等待任意任务 ⭐⭐⭐⭐

阶段 6：高级应用（持续学习）⭐⭐⭐⭐⭐

目标： 掌握高级功能和行业最佳实践

学习内容： 1. 组件建模（自定义行为） 2. 运动学建模 3. 碰撞检测优化（Colliders） 4. 性能优化 5. 大型项目管理

推荐资源： - 论坛精华帖 - 官方高级教程 - 行业案例研究

实战练习： - 创建自定义组件 - 优化大型仿真性能 - 实施完整工厂项目

📚 核心内容

Python 3 API ⭐⭐⭐⭐⭐

快速入门

导入模块：

import vcCore as vc
import vcBehaviors as vcb

第一个脚本：

import vcCore as vc

async def OnRun():
    comp = vc.getComponent()
    print(f"组件名称：{comp.Name}")

    # 等待 3 秒
    await vc.delay(3.0)

    print("3 秒后执行")

核心方法详解

1. getApplication() - 获取应用对象

app = vc.getApplication()
print(f"版本：{app.Version}")
print(f"仿真时间：{app.SimulationTime}")

2. getComponent() - 获取组件对象

comp = vc.getComponent()
print(f"组件：{comp.Name}")

# 查找子组件
child = comp.findNode("ChildNode")
behavior = comp.findBehavior("MyBehavior")
signal = comp.findSignal("MySignal")

3. delay() - 延时等待

await vc.delay(5.0)  # 等待 5 秒

4. condition() - 条件等待

# 等待信号为 True
await vc.condition(lambda: sensor.Value == True)

# 带超时
await vc.condition(
    lambda: sensor.Value == True,
    timeout=10.0
)

# 多信号条件
await vc.condition(
    lambda: sig1.Value and sig2.Value and sig3.Value
)

5. allTasks() - 等待所有任务

task1 = vc.delay(5.0)
task2 = vc.delay(3.0)
task3 = vc.delay(7.0)

await vc.allTasks([task1, task2, task3])

6. anyTask() - 等待任意任务

t1 = signal1.OnSignal.wait()
t2 = signal2.OnSignal.wait()
t3 = emergency.OnSignal.wait()

await vc.anyTask([t1, t2, t3])

完整示例：传送带控制

import vcCore as vc

async def OnRun():
    comp = vc.getComponent()

    # 获取组件
    conveyor = comp.findBehavior("Conveyor")
    start_btn = comp.findBehavior("StartButton")
    stop_btn = comp.findBehavior("StopButton")
    emergency = comp.findBehavior("EmergencyStop")
    part_sensor = comp.findBehavior("PartSensor")

    running = False
    process_time = 5.0

    print("传送带系统就绪")

    while True:
        # 创建任务列表
        tasks = [
            start_btn.OnSignal.wait(),
            stop_btn.OnSignal.wait(),
            emergency.OnSignal.wait(),
            part_sensor.OnSignal.wait()
        ]

        # 等待任意事件
        await vc.anyTask(tasks)

        # 紧急停止（最高优先级）
        if emergency.Value:
            print("🚨 紧急停止！")
            conveyor.Value = False
            running = False
            continue

        # 启动
        if start_btn.Value and not running:
            print("▶️ 启动传送带")
            running = True
            conveyor.Value = True

        # 停止
        if stop_btn.Value:
            print("⏹️ 停止传送带")
            running = False
            conveyor.Value = False

        # 工件检测
        if part_sensor.Value and running:
            print("📦 检测到工件")
            conveyor.Value = False

            # 加工
            await vc.delay(process_time)

            print("✅ 加工完成")
            conveyor.Value = True

论坛精华 ⭐⭐⭐⭐⭐

精华 1: CAD Attribute Reader 示例

链接： https://forum.visualcomponents.com/t/cad-attribute-reader-example/3205
浏览： 3.7k | 回复： 30 | 价值： ⭐⭐⭐⭐⭐

内容： 2D CAD 转 3D 布局工具

使用方法： 1. 下载插件（论坛附件） 2. 导入 2D DWG 文件 3. 自动转换为 3D 布局 4. 配置工艺逻辑

适用场景： - 从旧版图纸快速生成 3D 布局 - 批量转换 - 自动化产线设计

精华 2: 不同工件加工时间设置

链接： https://forum.visualcomponents.com/t/different-processing-time-for-each-part-on-same-machine/1411
浏览： 2.2k | 回复： 11 | 价值： ⭐⭐⭐⭐⭐

内容： 在同一机器上为不同工件设置不同加工时间

实现方法：

import vcCore as vc

async def OnRun():
    comp = vc.getComponent()
    input_buffer = comp.findFeature("InputBuffer")

    while True:
        part = input_buffer.getPart()

        if part:
            # 根据工件类型设置时间
            if part.Name == "Part_A":
                process_time = 5.0
            elif part.Name == "Part_B":
                process_time = 8.0
            else:
                process_time = 3.0

            await vc.delay(process_time)

适用场景： - 多品种混线生产 - 柔性制造系统 - 节拍优化

精华 3: Works Library 路径查找指南

链接： https://forum.visualcomponents.com/t/works-library-pathfinding-reference-guide/502
浏览： 3.3k | 回复： 7 | 价值： ⭐⭐⭐⭐⭐

内容： AGV 路径规划完整参考指南

核心内容： 1. 路径网络配置 2. AGV 调度逻辑 3. 避障设置 4. 多 AGV 协同 5. 充电站管理

适用场景： - AGV 物流系统 - 智能仓储 - 产线物料配送

精华 4: Python 脚本入门指南

链接： https://forum.visualcomponents.com/t/getting-started-with-python-scripting/8555
浏览： 500+ | 回复： 5 | 价值： ⭐⭐⭐⭐

内容： Python 脚本零基础入门

学习路径： 1. Python 基础语法 2. VC API 入门 3. 组件建模 4. 工艺逻辑 5. 高级应用

完整说明书 ⭐⭐⭐⭐⭐

目录速查

章节 主题 重要性
第 1 章 VC 5.0 概述 ⭐⭐⭐
第 2 章 系统要求与安装 ⭐⭐
第 3 章 软件界面与操作 ⭐⭐⭐⭐
第 4 章 布局配置 ⭐⭐⭐⭐
第 5 章 3D 操作 ⭐⭐⭐⭐
第 6 章 连接与通信 ⭐⭐⭐⭐⭐
第 7 章 仿真功能 ⭐⭐⭐⭐
第 8 章 工艺建模 ⭐⭐⭐⭐⭐
第 9 章 机器人编程 ⭐⭐⭐⭐⭐
第 10 章 组件建模 ⭐⭐⭐
第 11 章 导入导出 ⭐⭐⭐
第 12 章 Python API ⭐⭐⭐⭐⭐

🔧 实战项目

项目 1: 简单码垛站（新手）

难度： ⭐⭐
时间： 2-3 小时

目标： 创建一个简单的机器人码垛工作站

步骤： 1. 从 eCatalog 添加机器人 2. 添加传送带和托盘 3. 创建码垛路径 4. 配置工艺逻辑 5. 运行仿真

技能点： - 机器人导入 - 路径规划 - 工艺建模

项目 2: 智能分拣系统（中级）

难度： ⭐⭐⭐
时间： 1-2 天

目标： 实现基于视觉识别的自动分拣

步骤： 1. 创建多条传送带 2. 添加视觉传感器（模拟） 3. 编写 Python 控制脚本 4. 实现分拣逻辑 5. 数据分析

技能点： - Python 编程 - 信号处理 - 条件等待

示例代码：

async def OnRun():
    # 等待视觉识别结果
    await vc.condition(lambda: vision_result.Value != "")

    part_type = vision_result.Value

    if part_type == "A":
        diverter_a.Value = True
        await vc.delay(2.0)
        diverter_a.Value = False
    elif part_type == "B":
        diverter_b.Value = True
        await vc.delay(2.0)
        diverter_b.Value = False

项目 3: 完整产线仿真（高级）

难度： ⭐⭐⭐⭐⭐
时间： 1-2 周

目标： 创建完整的工厂产线仿真

步骤： 1. 导入 CAD 布局 2. 配置所有设备 3. 编写控制逻辑 4. 连接 PLC（虚拟） 5. 虚拟调试 6. 性能优化

技能点： - 大型项目管理 - 虚拟调试 - 性能优化 - 团队协作

📊 核对清单

发布前核对（针对技术内容）

机器人品牌列表： - [ ] 核对官方 22 个后处理器品牌 - [ ] 区分后处理器 vs eCatalog - [ ] 标注不在列表的品牌

软件版本： - [ ] VC 版本号（5.0） - [ ] Python 版本（3.12.2） - [ ] 发布日期（2026 年 3 月 12 日）

技术信息： - [ ] 所有参数与官方一致 - [ ] 所有链接可访问 - [ ] 所有代码可运行

🎓 学习建议

新手建议

  1. 从简单开始 - 不要一开始就挑战复杂项目
  2. 多动手实践 - 光看不练学不会
  3. 善用官方文档 - 遇到问题先查文档
  4. 参与社区 - 论坛提问和分享
  5. 持续学习 - 技术不断更新

进阶建议

  1. 深入学习 Python - 编程能力决定上限
  2. 掌握虚拟调试 - 行业趋势
  3. 学习最佳实践 - 参考行业案例
  4. 建立代码库 - 积累可复用代码
  5. 分享经验 - 教学相长

🔗 资源汇总

官方资源

资源 链接 说明
官网 https://www.visualcomponents.com/ 最新动态
帮助文档 https://help.visualcomponents.com/ 技术文档
VC 学院 https://academy.visualcomponents.com/ 官方教程
官方论坛 https://forum.visualcomponents.com/ 社区支持
YouTube https://www.youtube.com/@VisualComponentsOfficial 视频教程
eCatalog https://www.visualcomponents.com/ecatalog/ 组件库

学习资源

资源 链接 说明
Python 3 API 文档 https://help.visualcomponents.com/5.0/Premium/en/Python_3_API/Overview.html API 详解
发布说明 https://help.visualcomponents.com/5.0/Premium/en/English/Release_Notes/release_notes_5.0.htm 5.0 新功能
机器人 OLP https://www.visualcomponents.com/products/robot-offline-programming/ OLP 介绍
案例研究 https://www.visualcomponents.com/case-studies/ 行业案例

社区资源

平台 链接 说明
B 站 https://search.bilibili.com/all?keyword=Visual%20Components 中文视频
GitHub https://github.com/search?q=visual+components+python 开源项目

❓ 常见问题

Q1: 新手从哪里开始学？

A: 按照本技能的学习路径，从阶段 1 开始，逐步进阶。

Q2: Python 2 还能用吗？

A: VC 5.x 期间仍可用，但建议尽快迁移到 Python 3。VC 6.0 将完全移除 Python 2 支持。

Q3: 如何导出机器人程序？

A: 1. 完成路径规划 2. 机器人编程 → 导出程序 3. 选择机器人品牌（22 个官方支持） 4. 保存代码

Q4: JAKA 机器人支持吗？

A: - eCatalog: ✅ 有模型（可用于仿真） - 后处理器: ❌ 无官方后处理器（不能导出代码）

Q5: 如何学习虚拟调试？

A: 1. 先掌握基础仿真 2. 学习 OPC UA 或 MQTT 3. 连接虚拟 PLC 4. 参考官方虚拟调试教程

💡 总结

Visual Components 5.0 是一款强大的 3D 制造业仿真软件，掌握它需要：

  1. 系统学习 - 按照本技能路径学习
  2. 动手实践 - 多做项目，积累经验
  3. 查阅文档 - 遇到问题查官方文档
  4. 社区交流 - 论坛提问和分享
  5. 持续更新 - 关注官方更新

核心理念：

准确性第一！ 所有技术信息必须与官方文档一致。

学习目标：

从新手到专家，全面掌握 VC 5.0！

版本：v1.0
创建：2026-03-13
作者：Robotqu
维护：小橙 🍊
参考：官方帮助文档（2026 年 3 月 12 日发布）