本地截图上传
enableContentInspect:config:
开启/关闭本地截图上传。
- (int)enableContentInspect:(BOOL)enabled config:(AgoraContentInspectConfig* _Nonnull)config;
开启本地截图上传后，SDK 会根据你在 AgoraContentInspectConfig 中设置的模块类型和频率对本地用户发送的视频进行截图和上传。截图完成后，声网服务器会以 HTTPS 请求的形式，向你的服务器发送回调通知，并将所有截图发送至你指定的第三方云存储。
调用时机
加入频道前后均可调用。
调用限制
- 调用该方法前，请确保已联系技术支持开通本地截图上传服务。
- 视频审核模块选择声网自研插件截图上传（AgoraContentInspectTypeSupervise）时需集成本地截图上传动态库
AgoraContentInspectExtension.framework，如果删除该动态库会导致无法正常开启本地截图上传功能。
参数
- enabled
- 设置是否开启本地截图上传：
YES：开启本地截图上传。NO：关闭本地截图上传。
- config
- 本地截图上传配置。详见 AgoraContentInspectConfig。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
enableContentInspectEx:config:connection:
开启/关闭本地截图上传。
- (int)enableContentInspectEx:(BOOL)enabled config:(AgoraContentInspectConfig* _Nonnull)config connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(enableContentInspectEx(_:config:connection:));
该方法可以对多条视频流截图并上传。开启本地截图上传后，SDK 会根据你在 AgoraContentInspectConfig 中设置的模块类型和频率对本地用户发送的视频进行截图和上传。截图完成后，声网服务器会以 HTTPS 请求的形式，向你的服务器发送回调通知，并将所有截图发送至你指定的第三方云存储。
调用时机
加入频道前后均可调用。
调用限制
调用该方法前，请确保已联系技术支持开通本地截图上传服务。
参数
- enabled
- 设置是否开启本地截图上传：
YES：开启本地截图上传。NO：关闭本地截图上传。
- config
- 本地截图上传配置。详见 AgoraContentInspectConfig。
- connection
- Connection 信息。详见 AgoraRtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
takeSnapshot:filePath:
获取视频截图。
- (NSInteger)takeSnapshot:(NSInteger)uid filePath:(NSString* _Nonnull)filePath;
该方法用于对指定用户的视频流进行截图，生成一张 JPG 格式的图片，并保存至指定的路径。
调用时机
该方法需要在加入频道后调用。
调用限制
- 该方法是异步操作，调用返回时 SDK 并没有真正获取截图。
- 该方法用于本地视频截图时，是对 AgoraRtcChannelMediaOptions 中指定发布的视频流进行截图。
- 如果用户的视频经过前处理，例如，添加了水印或美颜，生成的截图会包含前处理效果。
相关回调
成功调用该方法后，SDK 会触发 rtcEngine:snapshotTaken:filePath:width:height:errCode: 回调，报告截图是否成功和获取截图的详情。
参数
- uid
- 用户 ID。如果要对本地用户的视频截图，则设为 0。
- filePath
- 截图的本地保存路径，需精确到文件名及格式，例如：
- macOS:
～/Library/Logs/example.jpg
注意请确保目录存在且可写。 - macOS:
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
takeSnapshotEx:uid:filePath:
使用连接 ID 获取视频截图。
- (NSInteger)takeSnapshotEx:(AgoraRtcConnection * _Nonnull)connection uid:(NSInteger)uid filePath:(NSString* _Nonnull)filePath;
该方法用于对指定用户的视频流进行截图，生成一张 JPG 格式的图片，并保存至指定的路径。
调用时机
该方法需要在 joinChannelExByToken:connection:delegate:mediaOptions:joinSuccess: 后调用。
调用限制
- 该方法是异步操作，调用返回时 SDK 并没有真正获取截图。
- 该方法用于本地视频截图时，是对 AgoraRtcChannelMediaOptions 中指定发布的视频流进行截图。
- 如果用户的视频经过前处理，例如，添加了水印或美颜，生成的截图会包含前处理效果。
相关回调
成功调用该方法后，SDK 会触发 rtcEngine:snapshotTaken:filePath:width:height:errCode: 回调，报告截图是否成功和获取截图的详情。
参数
- connection
- Connection 信息。详见 AgoraRtcConnection。
- uid
- 用户 ID。如果要对本地用户的视频截图，则设为 0。
- filePath
- 截图的本地保存路径，需精确到文件名及格式，例如：
- macOS:
～/Library/Logs/example.jpg
注意请确保目录存在且可写。 - macOS:
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
rtcEngine:snapshotTaken:filePath:width:height:errCode:
视频截图结果回调。
- (void)rtcEngine:(AgoraRtcEngineKit* _Nonnull)engine snapshotTaken:(NSUInteger)uid filePath:(NSString* _Nonnull)filePath width:(NSInteger)width height:(NSInteger)height errCode:(NSInteger)errCode;
详情
成功调用 takeSnapshot:filePath: 后，SDK 触发该回调报告截图是否成功和获取截图的详情。
参数
- engine
- AgoraRtcEngineKit 对象。
- uid
- 用户 ID。如果 uid 为 0，表示本地用户。
- filePath
- 截图的本地保存路径。
- width
- 图片宽度（px）。
- height
- 图片高度（px）。
- errCode
- 截图成功的提示或失败的原因。
- 0：截图成功。
- < 0: 截图失败。
- -1：写入文件失败或 JPEG 编码失败。
- -2：takeSnapshot:filePath: 方法调用后 1 秒内没有收到指定用户的视频帧。可能的原因有：本地采集停止、远端停止发布或者视频数据处理堵塞。
- -3：takeSnapshot:filePath: 方法调用过于频繁。