P2P连线模块介绍
P2P连线接口是Kalay SDK针对iOS平台提供的核心设备连接能力接口集，主要用于设备连接认证、指定通道断开、全通道断开等关键场景，为APP实现与设备的稳定P2P连接及音视频出图提供标准化调用方式。
KY_Connect
功能描述:连接设备并解码出图，支持不同认证方式和视频数据输出格式配置。
接口定义
- (void)KY_Connect:(NSString * _Nonnull)uid
authKey:(NSString * _Nonnull)authKey
authType:(AvAuthType)authType
password:(NSString * _Nonnull)password
channel:(NSInteger)channel
isDecode:(BOOL)isDecode
renderType:(RENDERTYPE)renderType;
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| uid | NSString * | 设备唯一标识符 (UID) |
| authKey | NSString * | 用于 AuthKey 方式认证的密钥。 |
| authType | AvAuthType | 认证类型枚举（例如，密码认证或 AuthKey 认证）。 |
| password | NSString * | 设备访问密码（当 authType 为密码认证时使用）。 |
| channel | NSInteger | 要开启并出图的通道号，默认值为 0。 |
| isDecode | BOOL | 是否进行解码并渲染画面，默认为 YES。 |
| renderType | RENDERTYPE | 指定渲染输出的数据类型。参考 RENDERTYPE 枚举 定义。 |
RENDERTYPE 枚举
| 枚举值 | 说明 |
|---|---|
OUTPUT_EMPTY (0) | 仅接收、解码、渲染视频流，不对外输出原始数据。 |
OUTPUT_YUV (1) | 接收、解码、渲染，并输出 I420 格式的 YUV 数据（此操作会消耗额外性能）。 |
OUTPUT_RGB_8888 (2) | 接收、解码、渲染，并输出 RGB_8888 格式的数据（此操作会消耗额外性能）。 |
OUTPUT_RGB_565 (3) | 接收、解码、渲染，并输出 RGB_565 格式的数据（此操作会消耗额外性能）。 |
OUTPUT_YUV_NV12 (4) | 接收、解码、渲染，并输出 NV12 格式的 YUV 数据（此操作会消耗额外性能）。 |
回调说明
连接状态和结果通常通过设置 delegate 并实现相应的回调方法来获取（例如，
KY_DeviceStatus）。返回码
详细的返回码会在 delegate 的回调方法中提供。
代码示例
// 假设 self.camera 是一个已经初始化的 KYCamera 实例
// self.uid, self.pwd, _mainChannel, self.isAuthToken, self.authKey 已提前设置
[self.camera KY_Connect:self.uid
authKey:self.authKey
authType:(self.isAuthToken ? AvAuthTypeAuthKey : AvAuthTypePassword)
password:self.pwd
channel:_mainChannel
isDecode:YES
renderType:OUTPUT_YUV];
KY_Disconnect
功能描述:断开指定通道的连接，并停止该通道的音视频功能。
接口定义
- (void)KY_Disconnect:(NSInteger)channel;
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| channel | NSInteger | 要断开连接的通道号，通常为 0。 |
回调说明
断开状态通常通过设置 delegate 并实现
KY_DeviceStatus 回调方法来获取。返回码
该接口无返回值，操作结果可通过 delegate 回调判断。
代码示例
[self.camera KY_Disconnect:_mainChannel];
KY_DisconnectAll
功能描述:停止并断开与该设备的所有通道连接。
接口定义
- (void)KY_DisconnectAll;
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| 无 | - | 该接口无需传入参数 |
回调说明
断开状态通常通过设置 delegate 并实现
KY_DeviceStatus 回调方法来获取。返回码
该接口无返回值，操作结果可通过 delegate 回调判断。
代码示例
[self.camera KY_DisconnectAll];
