takeLocalSnapshotToFile method
@detail api
@valid since 3.60.
@author wangfujun.911
@brief 截取本地的视频流画面,生成 JPG 文件,并保存到本地指定路径。
调用该方法后,SDK 会触发回调 rtcEngine:onLocalSnapshotTakenToFile:filePath:width:height:errorCode:taskId:{@link #ByteRTCEngineDelegate#rtcEngine:onLocalSnapshotTakenToFile:filePath:width:height:errorCode:taskId} 报告截图是否成功,以及截取的图片信息。
@param filePath 截图的本地保存路径(绝对路径),需精确到文件名及格式,文件扩展名必须为 .jpg,并请确保路径存在且可写。示例:/Users/YourName/Pictures/snapshot.jpg。
@return 本地截图任务的编号,从 1 开始递增。此编号可用于追踪任务状态或进行其他管理操作。
Implementation
FutureOr<NSInteger> takeLocalSnapshotToFile(NSString filePath) async {
return await nativeCall('takeLocalSnapshotToFile:', [filePath]);
}