# vvvv gamma 通道 — C# 集成 ## 什么是渠道通道是**命名、类型化、可观察的值容器**——vvvv gamma 中的中央反应式数据流机制。任何代码（补丁、C# 节点、外部绑定）都可以通过其字符串路径读取和写入通道。主要特性： * 每个通道都有一个 **path** （字符串）、一个 **type** 和一个 **current value** * 设置一个值会触发所有订阅者（反应式推送） * vvvv 为 MIDI、OSC、Redis 和 UI 提供内置通道绑定 * 通道在会话之间保持状态 ## 公共频道和 IChannelHub **公共频道**是在应用程序范围的频道中心中注册的频道 - 任何代码都可以通过字符串路径查找来访问。 ### 核心 API (`VL.Core.Reactive`) 使用 VL.Core.Reactive； // 获取应用程序范围的通道中心（单例） var hub = IChannelHub.HubForApp; // 安全查找 — 如果通道尚不存在则返回 null IChannel<对象>? ch = hub.TryGetChannel("MyApp.Settings.Volume"); // 读取当前值对象？值 = ch.Object; // 写入一个新值（触发所有订阅者） ch.Object = newValue; **关键：切勿使用 `hub.TryAddChannel()`** — 它会创建具有 `null` 值的通道，这会导致 vvvv 的 `SubChannelsBinding.EnsureMutatingPropertiesAreReflectedInChannels` 中出现 `NullReferenceException`。 SubChannel 系统尝试遍历空值的属性并崩溃。始终使用“TryGetChannel”（仅查找）。 ## [CanBePublished] 属性为了使 vvvv 将 .NET 类型属性公开为公共通道，该类型必须使用“VL.Core.EditorAttributes”中的“[CanBePublished(true)]”进行修饰。使用 VL.Core.EditorAttributes； // 当该类型发布时，所有公共属性都成为通道 [可以发布（true）] 公共类我的模型 { // 标准 .NET 类型直接工作 — float、bool、string、Vector3 等。公共浮动量 { 获取;放; } = 0.5f；公共布尔静音{得到;放; } = 假；公共字符串标签{获取;放; } =“默认”; // 完全对通道系统隐藏 [可以发布（假）] 公共字符串InternalId { 获取; } = Guid.NewGuid().ToString(); } 规则： * 类/结构上的“[CanBePublished(true)]” → 所有属性都作为通道发布 * 单个属性上的“[CanBePublished(false)]” → 将其隐藏在渠道系统中 * **.NET 类型默认不发布** — 该属性是必需的 * 从`VL.Core`版本`2025.7.1-0163`+开始可用 ## 通道路径约定通道使用点分隔的分层路径。展开元素使用括号表示法： Root.Page.Zone.Group.Parameter — 叶参数 Root.Page.Zone — 层次结构节点（模型对象） Root.Page.Items[0].PropertyName — 展开元素子通道 Root.Page.Items[2].DeleteInstance — 索引爆炸通道当发布带有“[CanBePublished(true)]”的类型时，子通道由 vvvv 的 SubChannel 系统**自动创建**。您不需要手动创建它们。使用“const string”路径常量以避免拼写错误：公共静态类 ChannelPaths { 公共 const string Volume = "Settings.Audio.Volume"; 公共常量字符串亮度=“App.Scene.Display.Brightness”; } ## 重试绑定模式当您的节点启动时，通道可能不存在 - vvvv 在模型初始化后发布它们。您必须重试每一帧，直到出现通道： [进程节点] 公共类 MyChannelReader ：IDisposable { 私有IChannel<对象>？ _渠道; 公共无效更新（输出浮点值） { // 重试直到通道存在如果（_channel == null） { var hub = IChannelHub.HubForApp; if (集线器!= null) _channel = hub.TryGetChannel("设置.音频.音量"); } // 读取值（使用安全转换） value = _channel?.Object 是 float f 吗？ f：0f； } 公共无效Dispose（）{_channel = null; } } 一旦绑定，缓存的引用在节点的生命周期内有效 - 无需重新查找。 ## PublicChannelHelper — 可重用实用程序封装重试绑定+可选订阅模式的帮助器类。可在任何项目中重复使用：公共类 PublicChannelHelper ：IDisposable { 私有IChannel<对象>？ _渠道; 私人ID一次性吗？ _订阅; 私有只读操作<对象？>？ _onNext；公共 PublicChannelHelper(Action<对象?>? onNext = null) { _onNext = onNext; } 公共 IChannel<对象>?频道 => _channel; public bool IsBound => _channel != null; public bool TryBind（IChannelHub集线器，字符串路径） { if (_channel != null) 返回 true； var ch = hub.TryGetChannel(路径); if (ch == null) 返回 false; _频道=频道； if (_onNext != null) _subscription = ch.Subscribe(new CallbackObserver(_onNext)); 返回真； } 公共无效处置（） { _subscription?.Dispose(); _订阅=空； _通道=空； } 私有密封类 CallbackObserver ： IObserver { 私有只读操作<对象？> _onNext; public CallbackObserver(Action onNext) => _onNext = onNext; 公共无效OnNext（对象？值）=> _onNext（值）；公共无效OnError（异常错误）{} 公共无效OnCompleted（）{} } } 在 ProcessNode 中的用法： [进程节点] 公共类 VolumeReader ：IDisposable { 私有只读 PublicChannelHelper _ch = new(); public void Update(out float value, out IChannel

Vvvv 频道

包含技能