鸿蒙5.0版开发:视频播放和录制-使用AVScreenCaptureRecorder录屏保存到文
往期鸿蒙全套实战文章必看:[*] 鸿蒙开发核心知识点,看这篇文章就够了
[*] 最新版!鸿蒙HarmonyOS Next应用开发实战学习门路
[*] 鸿蒙HarmonyOS NEXT开发技能最全学习门路指南
[*] 鸿蒙应用开发实战项目,看这一篇文章就够了(部门项目附源码)
使用AVScreenCaptureRecorder录屏保存到文件(ArkTS)
屏幕录制主要为主屏幕录屏功能。
开发者可以调用录屏(AVScreenCaptureRecorder)模块的ArkTs接口,完成屏幕录制,采集设备内、麦克风等的音视频源数据。可以调用录屏模块获取音视频文件,然后通过文件的情势流转到其他模块进行播放或处理,达成文件情势分享屏幕内容的场景。
录屏模块和窗口(Window)、图形(Graphic)等模块协同完成整个视频采集的流程。
使用AVScreenCaptureRecorder录制屏幕涉及到AVScreenCaptureRecorder实例的创建、音视频采集参数的设置、采集的开始与克制、资源的开释等。
开始屏幕录制时正在通话中大概屏幕录制过程中来电,录屏将主动克制。因通话中断的录屏会上报SCREENCAPTURE_STATE_STOPPED_BY_CALL状态。
本开发指导将以完成一次屏幕数据录制的过程为例,向开发者讲解如何使用
假如设置了采集麦克风音频数据,需对应设置麦克风权限ohos.permission.MICROPHONE和申请长时任务。
申请权限
在开发此功能前,开发者应根据实际需求申请相应权限。
权限名说明授权方式权限级别ohos.permission.MICROPHONE允许应用使用麦克风(可选)。user_grantnormalohos.permission.READ_IMAGEVIDEO允许应用读取用户外部存储中的媒体文件信息。user_grantnormalohos.permission.WRITE_IMAGEVIDEO允许应用读写用户外部存储中的媒体文件信息。user_grantnormal 开发步调及注意事项
使用AVScreenCaptureRecorder时要明确其状态的变化,在创建实例后,调用对应的方法可以进入指定的状态实现对应的行为。在确定的状态下执行不合适的方法会导致AVScreenCaptureRecorder发生错误,开发者必要在调用状态转换的方法前进行状态查抄,克制程序运行异常。
[*] 添加头文件。
import media from '@ohos.multimedia.media';
[*] 创建AVScreenCaptureRecorder类型的成员变量screenCapture。
// 声明一个AVScreenCaptureRecorder类型的变量
private screenCapture?: media.AVScreenCaptureRecorder;
// 创建一个AVScreenCaptureRecorder,并赋值给screenCapture成员变量
this.screenCapture = await media.createAVScreenCaptureRecorder();
[*] 对成员变量screenCapture设置监听函数,分别监听差别状态和异常情况。
this.screenCapture.on('stateChange', async (infoType: media.AVScreenCaptureStateCode) => {
switch (infoType) {
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STARTED:
console.info("录屏成功开始后会收到的回调");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_CANCELED:
this.screenCapture?.release();
this.screenCapture = undefined;
console.info("不允许使用录屏功能");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STOPPED_BY_USER:
this.screenCapture?.release();
this.screenCapture = undefined;
console.info("通过录屏胶囊结束录屏,底层录制会停止");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_INTERRUPTED_BY_OTHER:
console.info("录屏因其他中断而停止,底层录制会停止");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STOPPED_BY_CALL:
console.info("录屏过程因通话中断,底层录制会停止");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_MIC_UNAVAILABLE:
console.info("录屏麦克风不可用");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_MIC_MUTED_BY_USER:
console.info("录屏麦克风被用户静音");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_MIC_UNMUTED_BY_USER:
console.info("录屏麦克风被用户取消静音");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_ENTER_PRIVATE_SCENE:
// 目前可以从系统直接注册监听到进入隐私场景
console.info("录屏进入隐私场景");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_EXIT_PRIVATE_SCENE:
console.info("录屏退出隐私场景");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STOPPED_BY_USER_SWITCHES:
console.info("用户账号切换,底层录制会停止");
break;
default:
break;
}
})
this.screenCapture.on('error', (err) => {
console.info("处理异常情况");
})
[*] 设置屏幕录制参数。
创建AVScreenCaptureRecorder实例screenCapture后,可以设置屏幕录制所必要的参数。
参数videoBitrate、audioSampleRate、audioChannelCount、audioBitrate、preset为可选参数,若不设置则可按默认值进行设置,如下示例中提供了可选参数的默认值。麦克风和系统音的音频流共用一套音频参数,分别是音频采样率、音频通道数和音频比特率,对应audioSampleRate、audioChannelCount和audioBitrate参数。
captureConfig: media.AVScreenCaptureRecordConfig = {
// 开发者可以根据自身的需要设置宽高
frameWidth: 768,
frameHeight: 1280,
// 参考应用文件访问与管理开发示例新建并读写一个文件fd
fd: 0,
// 可选参数及其默认值
videoBitrate: 10000000,
audioSampleRate: 48000,
audioChannelCount: 2,
audioBitrate: 96000,
preset: media.AVScreenCaptureRecordPreset.SCREEN_RECORD_PRESET_H264_AAC_MP4
}
[*] 基于预先设置的屏幕录制参数,调用init()方法初始化screenCapture。
await this.screenCapture.init(this.captureConfig);
[*] 创建豁免隐私窗口,这里填写的是子窗口id和主窗口id
let windowIDs = ;
await screenCapture.skipPrivacyMode(windowIDs);
[*] 调用startRecording()方法开始进行屏幕录制,并通过监听函数监听状态。
await this.screenCapture.startRecording();
[*] 克制录屏。
[*] 点击录屏胶囊中的竣事按钮克制录制:基于回调函数实现,录屏对象实例screenCapture会触发SCREENCAPTURE_STATE_STOPPED_BY_USER的回调,通知应用此次录屏已克制,不必要开发者主动调用stopRecording()方法。
[*] 应用主动调用stopRecording()方法,克制录屏。
await this.screenCapture.stopRecording();
[*] 调用release()方法烧毁实例,开释资源。
await this.screenCapture.release();
完整示例
下面展示了使用AVScreenCaptureRecorder屏幕录屏存文件的完整示例代码。
import media from '@ohos.multimedia.media';
export class AVScreenCaptureDemo {
private screenCapture?: media.AVScreenCaptureRecorder;
captureConfig: media.AVScreenCaptureRecordConfig = {
// 开发者可以根据自身的需要设置宽高
frameWidth: 768,
frameHeight: 1280,
// 参考应用文件访问与管理开发示例新建并读写一个文件fd
fd: 0,
// 可选参数及其默认值
videoBitrate: 10000000,
audioSampleRate: 48000,
audioChannelCount: 2,
audioBitrate: 96000,
preset: media.AVScreenCaptureRecordPreset.SCREEN_RECORD_PRESET_H264_AAC_MP4
};
// 调用startRecording方法可以开始一次录屏存文件的流程,结束录屏可以通过点击录屏胶囊停止按钮进行操作。
public async startRecording() {
this.screenCapture = await media.createAVScreenCaptureRecorder();
if (this.screenCapture != undefined) {
// success
} else {
// failed
return;
}
this.screenCapture?.on('stateChange', async (infoType: media.AVScreenCaptureStateCode) => {
switch (infoType) {
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STARTED:
console.info("录屏成功开始后会收到的回调");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_CANCELED:
this.screenCapture?.release();
this.screenCapture = undefined;
console.info("不允许使用录屏功能");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STOPPED_BY_USER:
this.screenCapture?.release();
this.screenCapture = undefined;
console.info("通过录屏胶囊结束录屏,底层录制会停止");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_INTERRUPTED_BY_OTHER:
console.info("录屏因其他中断而停止,底层录制会停止");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STOPPED_BY_CALL:
console.info("录屏过程因通话中断,底层录制会停止");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_MIC_UNAVAILABLE:
console.info("录屏麦克风不可用");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_MIC_MUTED_BY_USER:
console.info("录屏麦克风被用户静音");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_MIC_UNMUTED_BY_USER:
console.info("录屏麦克风被用户取消静音");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_ENTER_PRIVATE_SCENE:
// 目前可以从系统直接注册监听到进入隐私场景
console.info("录屏进入隐私场景");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_EXIT_PRIVATE_SCENE:
console.info("录屏退出隐私场景");
break;
case media.AVScreenCaptureStateCode.SCREENCAPTURE_STATE_STOPPED_BY_USER_SWITCHES:
console.info("用户账号切换,底层录制会停止");
break;
default:
break;
}
})
this.screenCapture?.on('error', (err) => {
console.info("处理异常情况");
})
await this.screenCapture?.init(this.captureConfig);
// 豁免隐私窗口
let windowIDs = ;
await this.screenCapture?.skipPrivacyMode(windowIDs);
await this.screenCapture?.startRecording();
}
// 可以主动调用stopRecording方法来停止录屏。
public async stopRecording() {
if (this.screenCapture == undefined) {
// Error
return;
}
await this.screenCapture?.stopRecording();
// 调用release()方法销毁实例,释放资源。
await this.screenCapture?.release();
// 最后需要关闭创建的录屏文件fd, fs.close(fd);
}
} https://i-blog.csdnimg.cn/direct/92c637375237486096533d14e63eb83b.png
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页:
[1]