音频处理器中控协议.docx

音频处理器中控协议2023V3.O1目录1目录21概述31.1 协议规则32处理器模块42.1 输入处理42.2 输出处理52.3 灵敏度52.4 双展62.5 信号发生器62.6 扩展器72.7 均衡器82.8 压缩器112.9 自动增益122.10 压声器132.11 分享自动混音152.12 门限自动混音162.13 反馈抑制（限波型）192.15 噪声消除:222.16 回声消除232.17 音箱管理器242.18 限幅器262.19 语音跟踪262.20 场景使用262.21 电平上报272.22 输入输出步长调整272.23 输入输出电平值获取272.24 主混音271概述中控命令采用文本形式，即用ASCIl表达。1.1 协议规则发送命令的结构顺序：commandmoduleIdfieldkeyl:valuel,key2:value2.;接收命令结构顺序：result|commandmoduleldfieldkeyl:valuel,key2:value2.;参数说明： 参数之间用竖线“I”分隔，以分号结束，符号均为英文半角。 命令可多条同时发送，命令之间以分号分隔，各命令之间可换行或存在空格。 发送命令以Set或者get开头，以分号"结尾 接收命令以数字开头，以分号”结尾 命令各个参数说明：参数含义command命令。如get、Set等。具体支持哪些命令可通过查询对应模块对象类型所支持的命令列表获得。moduleld模块。UanteInputO1.0,表KianteInPUtOI处理器的第一个通道。设计好top。后，即可获得各处理器对象的名称。field范围。用于进一步描述模块的子参数。比如处理器的通道号编号等。keyl:valuel,键值对，为命令期望控制的参数列表。以冒号“:"分隔键和值，多个键值对之间已逗号分隔。如果type为查询，可不提供value。result返回值。0为正常，其它为错误的错误码。1.2 中控收发方式支持串口和网络收发中控指令。网络收发使用UDP,端Ll号5557。串口请先确认设备串口的参数，默认为9600。2处理器模块2.1输入处理commandmoduleldfieldkeyLvaluel命令含义keyvalue值类型值范围getset输入处理器名称通道号mute布尔false,true静音gain浮点,-72.000000-12.000000增益invert布尔falsextrue反相phant布尔false,true幻象供电name符字串0-9a-z通道名例子：1.1 获取第1个通道静音的参数：发送：getgainllmute;回复:OlgetlgainOIlllmute:false;1.2 设置第1个通道的为静音：发送:setgainllmutelrue;回复：0|set|gain01|l|mute:true;2.1 获取第1个通道增益的参数：发送：getgainllgain:回复:OlgetIgainOlIlIgain:-1.800000;2.2 设置第1个通道增益的参数发送：SeHgainOInlgain:3;回复:0|set|gain01|l|gain:3;21设置第1个通道增益的参数：发送:SetIgainoWgain:3;回复:0|set|gain01|l|gain:3;3.1 获取第1个通道的反相参数：发送：getAnaloglnput01linvert;回复:0|get|Analoglnput01|l|invert:false;3.2 设置第1个通道的反相参数：发送:SetlAnaloglnputoiIlIinvertirue;回复:OlsetlAnaloglnputoiIlIinvertlrue;4.1 获取第1个通道的名称参数:发送:getAnaloglnput01lname;回复:0getAnaloglnput01lnamerl;4.2 设置第1个通道的名称参数：发送：SeIlAnalogInPUtO11Iname:2;回复:0|set|Analoglnput01|l|name:2;5.1 获取第1个通道的幻象供电的参数：发送：getAnaloglnput01lphat;回复:0|get|Analoglnput01|l|phant：false;5.2 设置第1个通道的幻象供电的参数：发送:setAnaloglnput01lphantlrue;回复:OlsetlAnaloqlnputoiIlIphanttrue:commandmoduleldfieldkeylvaluel命令含义keyvalue类值型值范围getset输出处理器名称通道号mute布尔false、true静音gain浮点,-72.000000-12.000000增益name符字串0-9az通道名例子：1.1 获取第1个通道辞音的参数：发送:getgain02lmute;回复：OIgetIgain02|：IlmUte:false;1.2 设置第1个通道的为静音：发送：set|gainO2|l|mute:true;回复:0setgain02lmutelrue;2.1 获取第1个通道增益的参数：发送:getgainO2lgain;回复:0getgain02lgain:-21.300000：2.2 设置第1个通道增益的参数：发送：SetIgainO21Igain:3;回复:OlSeUgainO21Igain:3;3.1 获取第1个通道的名称参数:发送:getAnalogOutput01lname;回复：0IgetlAnaIOge)UtPUtOlIllname:1;3.2 设置第1个通道的名称参数.发送：SetlAnaIogOUtPUtOllIIname:2:回复：OlSeUAnalogoUtPUtOIiIlname:2;2.3灵敏度commandmoduleldfieldkeyl:valuel命令含义keyvalue类值型值范围getset处理器名称通道号sensitivity整型0、-10、-20,-30,-40灵敏度例子:1.1 获取第1个通道的灵敏度参数：发送:getAnaloglput01lsesitivity;回复getAnaloglnput01lsensitivity>20;1.2 设等第1个通道的灵敏度参数：发送：SetlAnaloglnPUtOIllISenSitiVity:-10;回复:0SetlAnalOgInPUtOIlIlSenSitiVity10;commandmoduleldfieldkeylvaluel.命令含义keyvalue值类型值范围getset处理器名称通道号src整型打开1-8通道:1017关闭1-8通道:0-7测试信号开关例子:1.1 获取第1个通道测试信号状态：发送：getrouter01lsrc;回复：OlgeUroUteroiIilSrC:0;1.2 打开第1个通道测试信号：发送：setrouter01lsrc10;回复:0|set|gain02|l|mute:true;1.3 关闭第1个通道测试信号：发送：getrouter01lsrc;回复:0getrouter01lsrc0;2.1 获取第2个通道测试信号状态：发送：getrouter012src;回复：0|get|router01|2|src:l:2.2 打开第2个通道测试信号：发送:setrouter012srcll;回复:0setgain022src:11;23关闭第2个通道测试信号：发送:setrouter012srcl;回复:0setrouter012srl;2.5信号发生器commandmoduleldfieldkeyl:valuel.命令含义keyvalue值类型值范围set处理器名称无open布尔false、true开关type字符串正弦波:sin、粉红噪声:Pink、白噪声:White类型freq浮点20.000000-20000.000000频率电平浮点-60.00-24.00电平例子：1.1开启第1个通道信号发生器：发送:setsigalGe01openrue;回复：0|set|signalGen01|open:true;1.2设置第1个通道类型为粉红噪声:发送：SetlsignaIGenOlItypepink;回复:0|set|signalGen01|type:pink;1.3设置第1个通道频率为1000：发送:SeUSignalGenOIlfreq:1000;回复:OlSeUSignalGenOIlfreq:1000;1.4设置第1个通道电平为-26:发送：SetISignalGenollIeVeI:-26;回复:0setsignalGe01levek-26;2.1 开启第2个通道信号发生器：发送:setsigalGe02openrue;回复：0setsignalGen02openlre;2.2 设置第2个通道类型为正弦波：发送:set|signalGenO2|type:sin;回复:0|set|signalGen02|type:sin;2.3 设芭第2个通道频率为100.发送：set|signalGen02|freq:100;回复:OlSetiSignalGeno2freq:Io0;2.4 设置第2个通道电平为-6：发送:setsignalGenO2level>6;回复：OlSetlSignalGen02IeVeI:-6:commandmoduleldfieldkeyl:valuel命令含义keyvalue值类型值范围getset处理器名称通道号bypass布尔false、true直通threshold浮点-60.0-20.0阈值ratio浮点1.0-20.0比率attackTime整型1-1000启动时间(ms)releaseTime整型1-1000恢复时间(ms)例子：1.1 获取第1个通道直通的参数：发送：getexpanderllbypass;回复：O|get|expanderOl|l|bypass:false;1.2 设置第1个通道直通的参数发送:set|expander01|l|bypass:false;回复：0|set|expander01|l|bypass:false;2.1 获取第1个通道阈值的参数：发送：getexpander01lthreshold;回复：OIgetleXPanderOlnIthreShold:-21.800000;2.2 设置第1个通道闹值的参数：发送:set|expander01|l|threshold:2:回复:0|set|expander01|l|threshold:2;3.1 获取第1个通道的比率参数：发送：getexpander01lratio;回复:OlgetleXPanderol口Iratio:1.400000;3.2 设置第1个通道的比率参数：发送：SetIeXPanderOllIrati。:2;回复:0setexpander01lratio2;4.1 获取第1个通道的启动时间参数：发送.getexpander01lattackTime;回复：OlgetlexpanderOlIlIattackTime:1;4.2 设置第1个通道的启动时间参数：发送:SetIeXPanderOIllIauaCkTime:2;回复:OISeUeXPanderOIlIIattaCkTime:2;5.1 获取第1个通道的恢复时间参数：发送：getexpander01lreleaseTime;回复：0getexander01lreleaseTimel2;5.2 设置第1个通道的恢复时间参数：发送:setexpader01lreleaseTime2;回复:0|set|expander01|l|releaseTime:2;commandmoduleldfieldkeyl:valuel命令含义keyvalue值类型值范围getset处理器名称无bypass布尔falseXtrue全部直通/段直通type字符串PeakingNotch,H-Shelf,L-Shelf,HP、LP类型freq浮点20.000000-20000.000000中心频率gain浮点15.075.0增益bandwidth浮点0.01-6.67带宽例子:1.Ll获取第1个通道全部直通的参数：发送：getpeq01commonbypass;回复：0getpeq01commonbypassirue;1.1.2整置第1个通道全部直通的参数发送：setpeq1commonbypass:false;回复：0|set|peq01|common|bypass:false：121获取第1个通道第2段直通的参数：发送：getpeq1（filters.2bypass;回复：get|peq01|filters.2|bypass：true;122设置第1个通道第2段直通的参数：发送：SeUPeqOIlfiIterS.2IbyPaSs:false;回复:0setpeq01filters.2bypassfalse;131获取第1个通道第2段的类型参数.发送：getpeqlfilters.2type;回复：0getpeq01filters.2type;132设置第1个通道第2段的类型参数：发送：SetlPeqOIIfiIterS.2ItyPe:HP;回复：OISetlPeqOIlfiIterS.2ItyPe:HP;141获取第1个通道第2段的中心频率参数.发送：getpeqlfilters.2freq;回复：0getpeq0111lters.2freq20.000000;142设置第1个通道第2段的中心频率参数：发送：$et|peq01|filter$.2|freq:30;回复:0|set|peq01|filters.2|freq:30;15耍取第1个通道第2段的增益参数：发送：getpeqlfilters.2gain;回复:OIgetIPeq（Hlfme喀.2Igain:0.000000;152设置第1个通道第2段的增益参数：发送:setpeql|filters.2|gain:4；回复:OlSetlPeqOlIfilterS.2Igaln:4;161获取第1个通道第2段的带宽参数：发送：getpeq01filters.2bandWidth;回复：OIgetlPeqOIIfiIter$.2IbandWidth:0.500000;1.6.2设置第1个通道第2段的带宽参数：发送：SeUPeqOIIfilterS.2IbandWidth:3;回复:OISetlPeqolIfilterS.2IbandWidth:3;2.1.1 获取第2个通道全部直通的参数：发送：getpeq02commonbypass;回复：C）IgetlPeq02COmmonIbyPaSSlrUe;2.1.2 设置第2个通道全部直通的参数发送：set|peq02|common|bypass:false;回复:0setpeq02mmonbypassfalse;2.2.1 获取第2个通道第2段直通的参数：发送：getpeq02filters.2bypass:回复：getpeqO2filters.2bypasstrue;2.2.2设置第2个通道第2段直通的参数：发送：set|peq02|filters.2|bypass:false;回复:O|set|peqO2|filters.2|bypass:false;231获取第2个通道第2段的类型参数：发送.getpeq02filters.2type;回复：0getpeq02filters.2type;232设置第2个通道第2段的类型参数：发送:set|peqO2|filters.2|type:HP;回复:O|set|peqO2|filters.2|type:HP;241获取第2个通道第2段的中心频率参数：发送：getpeq02filters.2freq;回复:0|get|peq02|filters.2|freq:20.000000;242设置第2个通道第2段的中心频率参数：发送:set|peq02|filters.2|freq:30;回复:O|set|peqO2|filters.2|freq:3O;251获取第2个通道第2段的增益参数：发送：getpeq02filters.2gai;回复：O|get|peqO2|filters.2|gam:O.OOOOOO;252设置第2个通道第2段的增益参数：发送：set|peq02|filters.2|gain;4;回复:0|set|peq02|filters.2|gain:4;261获取第2个通道第2段的带宽参数：发送：getpeqO2filters.2bandWidth;回复：O|get|peqO2|filters.2|bandWidth:O.5OOOOO;262设置第2个通道第2段的带宽参数.发送：set|peqO2|filters.2|bandWidth:3;回复:0|set|peq02|filters.2|bandWidth:3;8.1.1 获取第8,个通道全部直通的参数：发送：getpeq08commonbypass;回复：OlgetlPeq08COmmOnlbyPass:true;8.1.2 设置第1个通道全部直通的参数发送：set|peq08|common|bypass：false;回复：0setpeq08commonbypassialse;821获取第8个通道第2段直通的参数：发送:getpeq08filters.2bypass;回复：get|peq08|filters.2|bypass:true：822设置第8个通道第2段直通的参数发送:set|peq08|filters.2|bypass:false;回复：0)setpeq08filters,2bypassialse;831获取第8个通道第2段的类型参数：发送:getpeq08filters.2type;回复：0getpeq08filters.2type;832设置第8个通道第2段的类型参数：发送：set|peqO8|filters.2|type:HP;回复：O|set|peqO8|filters.2|type:HP;841获取第8个通道第2段的中心频率参数：发送：getpeq08filters.2freq;回复：0|get|peq08|filters.2|freq:20.000000;842设置第8个通道第2段的中心频率参数：发送:set|peq08|filters.2|freq:30;回复：0|set|peq08|filters.2|freq:30;851获取第8个通道第2段的增益参数：发送:getpeq08filters.2gain;回复：O|get|peqO8|filters.2|gam:O.OOOOOO;852设置第8个通道第2段的增益参数：发送:setpeqO8filters.2gai4;回复:O|set|peqO8|filters.2|gain:4;861获取第8个通道第2段的带宽参数：发送：getpeqO8filters.2bandWidth;回复：0|get|peq08|filters.2|bandWidth:0.500(X)0：862设置第8个通道第2段的带宽参数：发送：set|peqO8|filters.2|bandWidth:3;回复：O|set|peqO8|filters.2|bandWidth:3;9.1.1 获取USB输入1全部直通的参数：发送：getpeq09commonbypass;回复：0|get|peq09|common|bypass:true;9.1.2 设置USB输入1全部直通的参数发送:set|peq09|common|bypass:false;回复:0|set|peq09|common|bypass:false;921获取USB输入1第2段直通的参数：发送：getpeq09filters.2bypass;回复：get|peqO9|filters.2|bypass:true;922设置USB输入1第2段直通的参数：发送：set|peqO9|filters.2|bypass:false;回复:0setpeq09flters.2bypassfalse;931获取USB输入1第2段的类型参数：发送：getpeq09filters.2type;回复：0getpeq09filters.2type;932设置USB输入1第2段的类型参数：发送:set|peqO9|filters.2|type:HP;回复:O|set|peqO9|filters.2|type:HP;941获取USB输入1第2段的中心频率参数：发送：getpeq09filters.2freq;回复:0|get|peq09|filters.2|freq:20.000000;942设置USB输入1第2段的中心频率参数：发送:set|peq09|filters.2|freq:30;回复：O|set|peqO9|filters.2|freq:3O;951获取USB输入1第2段的增益参数：发送:getpeq09filters.2gain;回复：0|get|peq09|filters.2|gain:0.000000;952设置USB输入1第2段的增益参数：发送：set|peq09|filters.2|gain:4;回复:OlSetlPeqO9。IterS.2Igain:4;961获取USB输入1第2段的带宽参数：发送.getpeqlOfilters.2bandWidth;回复：OlgetlPeqlOIfiIterS.2IbandWidth0500000;962设置USB输入1第2段的带宽参数：发送：set|peqO9|filters.2|bandWidth:3;回复：0|set|peq09|filters.2|bandWidth:3;10.1.1 获取USB输入2全部直通的参数：发送：getpeqlOcommonbypass;回复：0getpeqlOcommonbypasslrue;10.1.2 设置USB输入2全部直通的参数发送:setpeqlOcommonbypassfalse;回复:0|set|peqlO|common|bypass:false;1021获取US8输入2第2段直通的参数：发送：getpeqlfilters.2bypass;回复：get|peqlO|filters.2|bypass:true：10.2.2 设置USB输入2第2段直通的参数：发送：set|peqlO|filters.2|bypass:false;回复：OlSetlPeqlolfilterS.2IbyPaSs:false:1031获取USB输入2第2段的类型参数：发送：getpeqlfilters.2type:回复：0getpeq10fliters.2type;1032设置USB输入2第2段的类型参数:发送:SetIPeqlolfnterS.2ItyPe:HP;回复:O|set|peqlO|filters.2|type:HP;1041获取USB输入2第2段的中心频率参数：发送：getpeqlfilters.2freq;回复:0|get|peql0|filters.2|freq:20.000000;10.2.3 设置USB输入2第2段的中心频率参数：发送：set|peqlO|filters.2|freq:3O;回复:O|set|peqlO|filters.2|freq:3O;10.5.1 获取USB输入2第2段的增益参数：发送：getpeqlfilters,2gain;回复：OIgetlPeqIoIfilterS.2IgainoOoOOO0;10.5.2 设置USB输入2第2段的增益参数:发送：SetlPeqIOIfilterS.2Igain:4;回复:OlSetlPeqlOIfilterS.2Igain:4;10.6.1 获取USB输入2第2段的带宽参数：发送：getpeql0filters.2badWidth;回复：OlgetlPeqIoIfiIterS.2IbandWidth:0.500000;10.6.2 设置USB输入2第2段的带宽参数：发送：SetlPeqlOIfiIterS.2IbandWidth:3;回复:OlSetIPeqiOlfiIterS.2IbandWidth:3;2.8压缩器commandmoduleldfieldkeyLvaluel命令含义keyvalue类值型值范围getset处理器名称通道号bypass布尔false、true直通gain浮点-24.0-30.0增益threshold浮点-60.0-20.0阈值ratio浮点1.020.0比率attackTime整型1-1000启动时间(ms)releaseTime整型1-1000恢复时间(ms)例子：1.1 获取第1个通道直通的参数：发送：getcompressor01lbypass;回复：OIgetlComPreSSorolIlbypass:false;1.2 设置第1个通道直通的参数发送：setcompressorO1111bypass:faIse;回复:OISetICOmPreSSorOIIlIbypass:false:2.1 获取第1个通道增益值的参数：发送：getcompressor01lgain:回复：OIgetlCOmPreSSOrOIlIlgain:-11.800000;2.2 设置第1个通道增益值的参数：发送：setcompressor011l|gain:2;回复:0|set|compressor01|l|gain:2;3.1 获取第1个通道闹值的参数：发送：getcompressor0111!threshold;回复:0getcompressor01lthreshold>21.800000;3.2 设置第1个通道阈值的参数：发送：SetIComPreSSOrOllllthreShold:2;回复:OlSetICOmPreSSOrOllIIthreShOld:2;4.1 获取第1个通道的比率参数：发送：getcompressor01lrato:回复:OlgetlcOmPreSSOrOlIlIratio:1.400000;4.2 设置第1个通道的比率参数:发送：SetlCornPreSSOrOIlIjratiO:2;回复:OlSetICOmPreSsOrOlllIratio:2;5.1 获取第1个通道的启动时间参数：发送.getcompressor01lattackTime;回复:0getcompressor01lattackTimel;5.2 设置第1个通道的启动时间参数：发送：set|compressor01|l|attackTime:2;回复:OISetlCOmPresSOrOllllattaCkTime:2;6.1 获取第1个通道的恢复时间参数：发送：getcompressor01lreleaseTime;回复：OlgetlComPreSSorolIlIreleaSeTime:12;6.2 设置第1个通道的恢复时间参数：发送:setmpressor01lreleaseTime2;回复:OlSetICOmPreSSorOllllreleaSeTime2commandmoduleldfieldkeylvaluel.命令含义keyvalue值类型值范围getset处理器名称通道号bypass布尔false、true直通threshold浮点-60.0-20.0阈值targetLevel浮点-28.0-20.0目标阈值ratio浮点1.0-20.0比率attackTime整型1-1000启动时间(ms)releaseTime整型l'1000恢复时间(ms)例子:11获取第1个通道直通的参数：发送：getagcllbypass;回复：O|get|agcOl|l|bypass:true;1.2设置第1个通道直通的参数发送:SelIagCollllbypass:false;回复:0|set|agc01|l|bypass:false;2.1 获取第1个通道阈值的参数：发送:getagc01lthreshold;回复：0getagc01lthreshold>11.800000:2.2 设置第1个通道目标阈值的参数：发送:SetIagCOIlIIthreShOId:2;回复：OISetIagCOIIIIthreShold23.1 获取第1个通道目标阈值的参数：发送：getagc01ltargetLevel:回复：OlgetlagCOIlIItargetLeVeI:-21,800000;3.2 设置第1个通道阚值的参数:发送:SetlagColnltargetLeVel:2;回复:OlSeUagCOInItargetLeVet2;4.1 获取第1个通道的比率参数：发送:getagc01lratio;回复：OlgetlagCOlIIkatio2400000;4.2 设置第1个通道的比率参数：发送:SetIagCOIlIIrati。25;回复：OIsetIagcOIIIIrati。25;5.1 获取第1个通道的启动时间参数：发送:getagclIIattackTime;回复:OlgetlagCO1口IattaCkTime:5;5.2 设置第1个通道的启动时间参数：发送:setagclIIattackTime:!;回复：OlSetIagColIllattaCkTime:1;6.1 获取第1个通道的恢复时间参数：发送：getagc01lreleaseTime;回复:OlgetIagCoIlIKeleaSeTime:22;6.2 设置第1个通道的恢复时间参数：发送:SetlagColllreIeaSeTime:32;回复OlSetlageo1|：LIreIeaSeTime:32;commandmoduleldfieldkeylvaluel.命令含义keyvalue值类型值范围getset处理器名称无bypass布尔false、true直通mix布尔false、true呼叫输入/背景输入开关gain浮点-72.0-12.0增益threshold浮点-60.0-20.0阂值depth浮点0.0-96.0深度keepTime整型10-l00保持时间(ms)attackTime整型5-500启动时间(ms)releaseTime整型10'600释放时间(ms)例子:1.Ll获取"呼叫输入"1的状态：发送：getmixerll.lmix;回复:0getmixer01l.lmixlrue;1.1.2打开“呼叫输入”1发送：setmi×erll.lmi×lrue;回复:0|set|mixer01|l.l|mix:true;121获取“呼叫输入u2的状态：发送：getmixerl2.1mix;回复:OIgetlmiXerO12.1Imixtre;122打开呼叫输入"2发送:SetlmiXeroII2.1Imix:true;回复：0|$.et|mixer01|2.i|mix:true;1.9.1 获取”呼叫输入mUSBI的状态:发送:getm