### 视频处理器控制板——会议室视频控制Con16使用说明
#### 一、按键编辑模式及按键事件配置
在视频处理器控制板中，我们可以通过特定的命令来配置按键的功能，实现对各种设备的控制。下面详细介绍如何进行按键编辑以及配置按键事件。
##### 进入按键编辑状态
要对一个按键进行编辑，首先需要进入按键编辑模式：
```
HS-KEY16-keyedit-按键编号->
```
例如，如果要编辑第1个按键，则输入：
```
HS-KEY16-keyedit-01->
```
进入编辑模式后，可以对按键进行各种配置。
##### 按键事件的添加与删除
一个按键可以在三种状态下产生按键码，分别是按键按下、按键按住和按键弹起时。
- **添加按键按下事件**：在按键编辑模式下，发送以下指令来添加一个按键按下事件，并进入该按键事件的编辑模式。
```
addact-onkeydown->
```
- **添加按键弹起事件**：如果需要在按键弹起时发送键码，可以先给按键添加按键弹起事件。
```
addact-onkeyup->
setcode-ascii-yyy
```
- **按键按住状态**：按键按住状态为持续发送键码，具体设置方法将在后面提到。
- **删除按键事件**：若不再需要某个按键事件，可以使用以下命令删除：
```
clract-onkeydown/onkeyhold/up
```
或者调用`clrkey`来清除某个按键的所有按键事件。
注意，最多只能添加20个按键事件。若超出限制，则无法添加新的按键事件。
##### 实例：控制继电器
假设我们需要通过按键1来控制继电器的导通和断开：
1. 进入按键1的编辑状态：
```
HS-KEY16-keyedit-01->
```
2. 添加按键按下事件并设置继电器导通：
```
addact-onkeydown->
setcode-HS-DNC-setrelay-05-01-on
```
3. 添加按键弹起事件并设置继电器断开：
```
addact-onkeyup->
setcode-HS-DNC-setrelay-05-01-off
```
配置完成后，当按下按键1时，继电器导通；当按键1被释放时，继电器断开。
#### 二、配置带有可变值的按键
当需要通过按键控制设备中的某些值的变化时，比如调整调光器亮度或音量等，可以使用带有变量的命令来实现动态调节。
##### 设置带有变量的按键
1. 进入按键1的编辑状态并添加按键按住事件：
```
HS-KEY16-keyedit-01->
addact-onkeyhold->
setcode-XX***
```
此时，按住按键1将不断发出键码“XX***”。
2. 绑定变量到“*”位置：
```
setvoid-01-var1
```
这时按键发出的码将变成“XX000”，其中“***”已经被变量var1绑定。
3. 设置变量var1的属性：
```
HS-KEY16-setvar-1-1-0-0-100-5-200-sub
```
- `HS-KEY16-setvar-按键编号-变量号-初始值-范围min-范围max-单位长度-间隔时间-方向`
上述指令表示将var1与按键1绑定，绑定后，按住按键1时，var1会变化。var1的初始值为0，范围为0~100，每200毫秒递减1。
若要调整发码速度，可以发送指令`settime-200`来设置按键发码的频率。
##### 实例：控制调光器亮度
假设我们需要通过按键1和按键2来分别控制调光器亮度的增加和减少（调光器id-07，通道3）：
1. 配置按键1：
```
HS-KEY16-keyedit-01->
addact-onkeyhold->
setcode-ascii-HS-DNC-setlight-07-03-***
setvoid-01-var1
HS-KEY16-setvar-1-1-0-0-100-5-200-sub
settime-200
```
2. 配置按键2：
```
HS-KEY16-keyedit-02->
addact-onkeyhold->
setcode-ascii-HS-DNC-setlight-07-03-***
setvoid-01-var1
HS-KEY16-setvar-2-1-0-0-100-5-200-add
settime-200
```
这样，按住按键1时，灯光逐渐变暗；按住按键2时，灯光逐渐变亮。
#### 三、通过按键控制设备状态的翻转或切换
如果希望通过按同一个按键来控制设备的状态翻转或是多个状态的切换，可以使用枚举变量来实现。
##### 添加枚举变量
1. 发送指令来添加一组枚举变量：
```
HS-KEY16-setenum-ascii-1-on#off
```
这样就添加了一组含有“on”和“off”的枚举变量。
2. 将枚举变量绑定到命令中的**位置：
```
setvoid-1-enum1
```
这将位置1的空缺和第一组枚举变量绑定起来。
##### 实例：控制继电器开关
假设需要通过按键1来控制继电器的开关（继电器id-05，通道1）：
1. 进入按键1的编辑状态并添加按键按下事件：
```
HS-KEY16-keyedit-01->
addact-onkeydown->
setcode-HS-DNC-setrelay-05-01-**
setvoid-01-enum1
```
配置完成后，每次按下按键1时，继电器的状态会在“on”和“off”之间切换。
通过以上步骤，我们可以根据实际需求灵活地配置按键功能，实现对视频处理器控制板的有效利用。
