区域共享

1 简介

设置成区域共享后，在多显示器下可以根据坐标共享对应区域内容。

本文主要讲述如何设置区域共享，详情请参考示例Demo。

2 步骤

1. 初始化

/*
设置日志路径和级别
*/
zego_screencapture_set_log_level(kZegoLogLevelDebug, logDir);

/*
设置捕获错误回调
*/
zego_screencapture_reg_capture_error_notify((zego_screencapture_capture_error_notify_func)OnCaptureError, this);

/*
设置捕获数据回调
*/
zego_screencapture_reg_captured_frame_available_notify((zego_screencapture_captured_frame_available_notify_func)OnCapturedFrameAvailable, this);

/*
初始化
*/
zego_screencapture_init();

2. 设置捕获参数

/*
设置桌面共享的采集帧率，即OnCapturedFrameAvailable每秒回调次数
*/
zego_screencapture_set_fps(framerate);

/*
设置是否同时捕捉光标
*/
zego_screencapture_set_cursor_visible(checked);

/*
设置是否在捕捉到共享画面的同时显示点击动画
*/
zego_screencapture_enable_click_animation(checked);

/*
设置视频采集的格式
*/
//zego_screencapture_set_capture_video_pixel_format(kZegoPixelFormatI420);
zego_screencapture_set_capture_video_pixel_format(kZegoPixelFormatBGRA32);

3.设置捕获区域

/*
获取虚拟桌面尺寸（多个屏幕合并后计算），单位为像素，支持高DPI及多屏坐标，原点坐标为主屏左上角
*/
int x(0), y(0), w(0), h(0);
zego_screencapture_get_virtual_desktop_rect(&x, &y, &w, &h);

/*
若选择共享某个区域，则将当前设置的区域矩形坐标传入
*/
QRect rect = m_settings->currentRectangle();
zego_screencapture_set_target_rect(0,rect.x(), rect.y(), rect.width(), rect.height());

4.开始捕获

/*
启动捕获
*/
zego_screencapture_start_capture();

5.数据接收

void ZegoScreenCaptureController::OnCapturedFrameAvailable(const char *data, uint32_t length, const struct ZegoScreenCaptureVideoCaptureFormat *video_frame_format, uint64_t reference_time, uint32_t reference_time_scale, void *user_data) 
{
    ZegoScreenCaptureController *pThis = (ZegoScreenCaptureController *)user_data;
    if (!pThis)
        return;

    auto externalDevice = pThis->m_externalCaptureFactory->Device();
    if (!externalDevice || !externalDevice->IsCapturing())
        return;

    if (!externalDevice->Client())
        return;

    // 从桌面分享SDK回调的桌面画面，直接传给音视频SDK推流
    AVE::VideoCaptureFormat format;
    format.width = video_frame_format->width;
    format.height = video_frame_format->height;

    if (video_frame_format->video_pixel_format == kZegoPixelFormatI420)
    {
        format.strides[0] = video_frame_format->strides[0];
        format.strides[1] = video_frame_format->strides[1];
        format.strides[2] = video_frame_format->strides[2];
    }
    else
    {
        format.strides[0] = video_frame_format->strides[0];
    }

    format.pixel_format = (AVE::VideoPixelFormat)video_frame_format->video_pixel_format;
    format.rotation = video_frame_format->rotation;
    externalDevice->Client()->OnIncomingCapturedData(data, length, format, reference_time, reference_time_scale);
}

6.停止捕获

/*
停止捕获
*/
zego_screencapture_stop_capture();