目录

使用AVScreenCapture实现窗口级录屏(C/C++)

从API version 10开始,开发者可通过AVScreenCapture模块的C API接口实现窗口/屏幕录屏,采集麦克风和设备的音视频源数据。

本开发指导以指定窗口录屏为例,介绍如何使用AVScreenCapture的C API实现精准窗口捕获。该方案聚焦特定窗口内容,避免全屏干扰,适用于教学演示、在线课程、会议记录及特定内容采集等场景。

申请权限

在开发此功能前,开发者应根据实际需求申请相关权限:

开发步骤及注意事项

在CMake脚本中链接动态库

target_link_libraries(entry PUBLIC libnative_avscreen_capture.so libability_runtime.so libnative_display_manager.so)
  1. 添加头文件。

    #include "hilog/log.h"
    #include "napi/native_api.h"
    #include <window_manager/oh_display_info.h>
    #include <window_manager/oh_display_manager.h>
    #include <AbilityKit/ability_runtime/application_context.h>
    #include <multimedia/player_framework/native_avscreen_capture.h>
    #include <multimedia/player_framework/native_avscreen_capture_base.h>
    #include <multimedia/player_framework/native_avscreen_capture_errors.h>
    #include <unistd.h>
    #include <fcntl.h>
    #include <string>
  2. 调用OH_AVScreenCapture_Create方法创建AVScreenCapture实例g_avCapture。

    g_avCapture = OH_AVScreenCapture_Create();
  3. 调用OH_AVScreenCapture_Init方法配置屏幕录屏参数。

    创建AVScreenCapture实例capture后,可以设置录屏所需要的参数。

    void SetConfig02(OH_AVScreenCaptureConfig &config, OH_RecorderInfo &recorderInfo)
    {
        // 录屏时获取麦克风或者内录,内录参数必填,如果都设置了,内录和麦克风的参数设置需要一致。
        OH_AudioCaptureInfo micCapInfo = {.audioSampleRate = 48000, .audioChannels = 2, .audioSource = OH_MIC};
    
        OH_AudioCaptureInfo innerCapInfo = {.audioSampleRate = 48000, .audioChannels = 2, .audioSource = OH_ALL_PLAYBACK};
        // 录屏音频输出规格配置。audioBitrate保证输出文件的比特率为设置的预期比特率,和audioSampleRate无强关联。
        // 为保证音频质量,此处音频比特率取值128000。如果录屏内容以语音为主,不包含音乐、游戏音效等,可以降低为96000或48000。
        OH_AudioEncInfo audioEncInfo = {
            .audioBitrate = 128000,
            .audioCodecformat = OH_AAC_LC
        };
    
        // 获取屏幕信息。
        uint64_t displayId = 0;
        NativeDisplayManager_ErrorCode ret = OH_NativeDisplayManager_GetDefaultDisplayId(&displayId);
    
        NativeDisplayManager_DisplayInfo* displayInfo = nullptr;
        ret = OH_NativeDisplayManager_CreateDisplayById(displayId, &displayInfo);
        if (ret != DISPLAY_MANAGER_OK || !displayInfo) {
            return;
        }
        int32_t screenWidth = displayInfo->width;
        int32_t screenHeight = displayInfo->height;
        OH_NativeDisplayManager_DestroyDisplay(displayInfo);
        displayInfo = nullptr;
        OH_VideoCaptureInfo videoCapInfo = {
            .videoFrameWidth = screenWidth,
            .videoFrameHeight = screenHeight,
            .videoSource = OH_VIDEO_SOURCE_SURFACE_RGBA
        };
    
        OH_VideoEncInfo videoEncInfo = {
            .videoCodec = OH_H264,
            .videoBitrate = 2000000,
            .videoFrameRate = 30
        };
    
        OH_AudioInfo audioInfo = {
            .micCapInfo = micCapInfo,
            .innerCapInfo = innerCapInfo,
            .audioEncInfo = audioEncInfo
        };
    
        OH_VideoInfo videoInfo = {
            .videoCapInfo = videoCapInfo,
            .videoEncInfo = videoEncInfo
        };
    
        config = {
            .captureMode = OH_CAPTURE_HOME_SCREEN,
            .dataType = OH_CAPTURE_FILE, // 录屏数据类型,文件。
            .audioInfo = audioInfo,
            .videoInfo = videoInfo,
            .recorderInfo = recorderInfo // 录制文件信息。
        };
        // 设置状态回调函数、错误回调函数和录屏屏幕ID回调函数等。
        SetCallbackFile(g_avCapture);
    }

    方式一(推荐):通过弹出屏幕捕获Picker列表方式,选择已打开的应用窗口进行窗口级录屏。

    // 通过弹出屏幕捕获Picker列表方式,选择已打开的应用窗口进行窗口级录屏。
    OH_AVScreenCapture_CaptureStrategy *strategy = OH_AVScreenCapture_CreateCaptureStrategy();
    OH_AVScreenCapture_StrategyForPickerPopUp(strategy, true);
    OH_AVScreenCapture_SetCaptureStrategy(g_avCapture, strategy);
    OH_AVScreenCapture_ReleaseCaptureStrategy(strategy);

    方式二:需传入期望录制的窗口ID进行录屏。

    // 如果期望录制单个窗口,需传入单个窗口ID;如果期望同时录制多个窗口,需传入期望录制的窗口ID列表。
    g_missionIds = {g_windowId}; // 指定录制的窗口ID。
    config.videoInfo.videoCapInfo.missionIDs = g_missionIds.data();
    config.videoInfo.videoCapInfo.missionIDsLen = static_cast<int32_t>(g_missionIds.size());
    config.captureMode = OH_CAPTURE_SPECIFIED_WINDOW; // 设置录屏模式为录制指定窗口。
    
    // 设置为false,代表录屏启动后不弹出系统Picker,弹出隐私提示弹窗。
    OH_AVScreenCapture_CaptureStrategy* strategy = OH_AVScreenCapture_CreateCaptureStrategy();
    OH_AVScreenCapture_StrategyForPickerPopUp(strategy, false);
    OH_AVScreenCapture_SetCaptureStrategy(g_avCapture, strategy);
    OH_AVScreenCapture_ReleaseCaptureStrategy(strategy);
  4. 调用OH_AVScreenCapture_StartScreenRecording方法开始进行窗口级录屏。

    result = OH_AVScreenCapture_StartScreenRecording(g_avCapture);
  5. 调用OH_AVScreenCapture_StopScreenRecording方法停止录屏。

    result = OH_AVScreenCapture_StopScreenRecording(g_avCapture);
  6. 调用OH_AVScreenCapture_Release方法销毁实例,释放资源。

    OH_AVScreenCapture_Release(g_avCapture);
    g_avCapture = nullptr;