本地截图上传
- Unreal Blueprint
更新时间不可用
EnableContentInspect
开启/关闭本地截图上传。
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
int EnableContentInspect(bool enabled, const FContentInspectConfig& config);开启本地截图上传后，SDK 会根据你在 FContentInspectConfig 中设置的模块类型和频率对本地用户发送的视频进行截图和上传。截图完成后，声网服务器会以 HTTPS 请求的形式，向你的服务器发送回调通知，并将所有截图发送至你指定的第三方云存储。
调用时机
加入频道前后均可调用。
调用限制
- 调用该方法前，请确保已在声网控制台开通本地截图上传服务。
- 视频审核模块选择声网自研插件截图上传（CONTENT_INSPECT_SUPERVISION）时需集成本地截图上传动态库
libagora_content_inspect_extension.dll，如果删除该动态库会导致无法正常开启本地截图上传功能。
参数
| 参数名 | 描述 |
|---|---|
enabled | |
config | 本地截图上传配置。详见 FContentInspectConfig。 |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
EnableContentInspectEx
开启/关闭本地截图上传。
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
int EnableContentInspectEx(bool enabled, const FContentInspectConfig& config, const FRtcConnection& connection);该方法可以对多条视频流截图并上传。开启本地截图上传后，SDK 会根据你在 FContentInspectConfig 中设置的模块类型和频率对本地用户发送的视频进行截图和上传。截图完成后，声网服务器会以 HTTPS 请求的形式，向你的服务器发送回调通知，并将所有截图发送至你指定的第三方云存储。
调用时机
加入频道前后均可调用。
调用限制
调用该方法前，请确保已联系技术支持开通本地截图上传服务。
参数
| 参数名 | 描述 |
|---|---|
enabled | |
config | 本地截图上传配置。详见 FContentInspectConfig。 |
connection | Connection 信息。详见 FUABT_RtcConnection。 |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
TakeSnapshot
对视频截图。
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
int TakeSnapshot(int64 uid, const FString& filePath);该方法用于对指定用户的视频流进行截图，生成一张 JPG 格式的图片，并保存至指定的路径。
调用时机
该方法需要在加入频道后调用。
调用限制
- 该方法是异步操作，调用返回时 SDK 并没有真正获取截图。
- 该方法用于本地视频截图时，是对 FChannelMediaOptions 中指定发布的视频流进行截图。
- 如果用户的视频经过前处理，例如，添加了水印或美颜，生成的截图会包含前处理效果。
相关回调
成功调用该方法后，SDK 会触发 OnSnapshotTaken 回调，报告截图是否成功和获取截图的详情。
参数
| 参数名 | 描述 |
|---|---|
uid | |
filePath |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
TakeSnapshotWithConfig
在指定观测位置进行视频截图。
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
int TakeSnapshotWithConfig(int64 uid, const FUABT_SnapshotConfig& config);该方法用于对指定用户的视频流进行截图，生成一张 JPG 格式的图片，并保存至指定的路径。
调用时机
该方法需要在加入频道后调用。
调用限制
- 该方法是异步操作，调用返回时 SDK 并没有真正获取截图。
- 该方法用于本地视频截图时，是对 FChannelMediaOptions 中指定发布的视频流进行截图。
相关回调
成功调用该方法后，SDK 会触发 OnSnapshotTaken 回调，报告截图是否成功和获取截图的详情。
参数
| 参数名 | 描述 |
|---|---|
uid | |
config | 截图设置，详见 FUABT_SnapshotConfig。 |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
TakeSnapshotEx
使用连接 ID 获取视频截图。
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
int TakeSnapshotEx(const FRtcConnection& connection, int64 uid, const FString& filePath);该方法用于对指定用户的视频流进行截图，生成一张 JPG 格式的图片，并保存至指定的路径。
调用时机
该方法需要在 JoinChannelEx 后调用。
调用限制
- 该方法是异步操作，调用返回时 SDK 并没有真正获取截图。
- 该方法用于本地视频截图时，是对 FChannelMediaOptions 中指定发布的视频流进行截图。
- 如果用户的视频经过前处理，例如，添加了水印或美颜，生成的截图会包含前处理效果。
相关回调
成功调用该方法后，SDK 会触发 OnSnapshotTaken 回调，报告截图是否成功和获取截图的详情。
参数
| 参数名 | 描述 |
|---|---|
connection | Connection 信息。详见 FUABT_RtcConnection。 |
uid | |
filePath |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
TakeSnapshotWithConfigEx
使用连接 ID 获取指定观测位置的视频截图。
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
int TakeSnapshotWithConfigEx(const FUABT_RtcConnection& connection, int64 uid, const FUABT_SnapshotConfig& config);该方法用于对指定用户的视频流进行截图，生成一张 JPG 格式的图片，并保存至指定的路径。
调用时机
该方法需要在 JoinChannelEx 后调用。
调用限制
- 该方法是异步操作，调用返回时 SDK 并没有真正获取截图。
- 该方法用于本地视频截图时，是对 FChannelMediaOptions 中指定发布的视频流进行截图。
- 如果用户的视频经过前处理，例如，添加了水印或美颜，生成的截图会包含前处理效果。
相关回调
成功调用该方法后，SDK 会触发 OnSnapshotTaken 回调，报告截图是否成功和获取截图的详情。
参数
| 参数名 | 描述 |
|---|---|
connection | Connection 信息。详见 FUABT_RtcConnection。 |
uid | |
config | 截图设置，详见 FUABT_SnapshotConfig。 |
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
OnSnapshotTaken
视频截图结果回调。
UFUNCTION(BlueprintNativeEvent, Category = "Agora|Event")
void OnSnapshotTaken(int64 uid, const FString& filePath, int width, int height, int errCode);详情
成功调用 TakeSnapshot 后，SDK 触发该回调报告截图是否成功和获取截图的详情。