控制协议

KY_SendIOCtrlToChannel

功能描述:

向设备发送指定Command的数据。需要在KY_Connect 连线成功之后进行调用。设备回复参考 KY_registerSDKListener 。

接口定义

public abstract void KY_SendIOCtrlToChannel(int channel, int type, byte[] data);

参数说明

参数	类型	说明
channel	int	设备连线的channel，默认0
type	int	command指令值
data	array	command对应指令的结构体数据

回调说明

暂无

返回码

暂无

代码示例

以下举例说明，在Android项目中，如何将bytes转成一个java对象：

private class People {
	int age = 0;//4 bytes means data[0] ~ data[3]
	long birthday = 1612330883993L;//8 bytes means data[4] ~ data[11]
String name = "";//custom bytes ex: 32 bytes
}
/**
 * byte to people
 *
 * @param data src bytes length & 44
 * @return people
 */
private People byteToPeople(byte[] data) {
	   if (data.length < 44) {
			  return null;
	   }
	   People p = new People();
	   p.age = byteArrayToInt(data, 0);
	   p.birthday = byteArrayToLong(data, 4);
	   byte[] name = new byte[32];
	   System.arraycopy(data, 12, name, 0, 32);
	   p.name = new String(name);
	   return p;
}

private short byteArrayToShort(byte[] bytes, int beginPos) {
	   return (short) ((0xff & bytes[beginPos]) | ((0xff & bytes[beginPos + 1]) << 8));
}

private int byteArrayToInt(byte[] bytes, int beginPos) {
	   return (0xff & bytes[beginPos]) | (0xff & bytes[beginPos + 1]) << 8 | (0xff & bytes[beginPos + 2]) << 16 | (0xff & bytes[beginPos + 3]) << 24;
}

private long byteArrayToLong(byte[] bytes, int beginPos) {
	   long l = 0;
	   for (int i = 0; i < 4; i++) {
			  l = l | ((0xffL & bytes[beginPos + i]) << (8 * i));
	   }
	   return l;
}

协议封装示例

定义协议及结构体

APP发送Command获取灯控开关状态：IOTYPE_GET_LED_REQ = 0x30000001
typedef struct{
	unsigned int channel;       //当前通道号
	unsigned char reserved[4];
}SMsgAVIoctrlGetLedReq;
  
设备端回复灯控开关状态：IOTYPE_GET_LED_RESP = 0x30000002
typedef struct{
	int result;        //0：成功,  其他失败
	unsigned char isOnOff;        // 0:开启； 1:关闭
	unsigned char reserved[3];
}SMsgAVIoctrlGetLedResp;

结构体封装与发送

//在结构体SMsgAVIoctrlGetLedReq中，因为int占4个字节，char占一个字节，所以发送出去的bytes大小为4 + 1*4 = 8
byte[] request = new byte[8];  //将int类型的channel数据转换为byte并复制数据到request数组中
byte[] channelBytes = Packet.intToByteArray_Little(channel);
System.arraycopy(channelBytes, 0, request, 0, 4);  //将封装好的byte[]数据通过api发送给设备
camera.KY_SendIOCtrlToChannel(Camera.DEFAULT_AV_CHANNEL, IOTYPE_GET_LED_REQ, request);

数据接收与解析

camera.KY_registerSDKListener(new InterfaceCtrl.SimpleIRegisterKalaySDKListener() {

	@Override
	public void KY_DidReceiveIOCtrlWithUid(String uid, int channel, int type, byte[] data, int dataSize) {
		if (type == IOTYPE_GET_LED_RESP) {
		//在结构体SMsgAVIoctrlGetLedResp中，因为int占4个字节，char占一个字节，所以接收到的bytes大小为4 + 1 + 1*3 = 8
		//其中，前面4个字节代表设备回复的result信息，第五个字节代表设备回复的isOnOff信息，后面三个字节代表保留位无需解析
			//1、解析result信息
			int result = Packet.byteArrayToInt(data, 0);
		
			//2、解析isOnOff信息
			int isOnOff = (int)data[4];
		}
	}
});