AVChatExternalVideoCapturer.java

浏览该文件的文档.

/*
 * Copyright (c) 2014-2018 NetEase, Inc.
 * All right reserved.
 */

package com.netease.nimlib.sdk.avchat.video;

import android.os.SystemClock;

import com.netease.nimlib.log.NimLog;
import com.netease.nimlib.sdk.avchat.AVChatManager;
import com.netease.nimlib.sdk.avchat.model.AVChatImageFormat;
import com.netease.nrtc.sdk.video.ExternalVideoCapturer;
import com.netease.nrtc.sdk.video.IVideoCapturer;
import com.netease.nrtc.sdk.video.VideoFrame;

import com.netease.nrtc.utility.video.VideoUtils;


/**
 * 继承该类，实现自定义外部视频数据输入
 */

public abstract class AVChatExternalVideoCapturer extends ExternalVideoCapturer implements AVChatVideoCapturer {

    /**
     * 开始预览
     *
     * @param width     采集宽
     * @param height    采集高
     * @param frameRate 采集分辨率
     */
    public abstract void startCapture(int width, int height, int frameRate);

    /**
     * 关闭预览
     *
     * @throws InterruptedException
     */
    public abstract void stopCapture() throws InterruptedException;

    /**
     * 修改采集的参数
     *
     * @param width     采集宽
     * @param height    采集高
     * @param frameRate 采集分辨率
     */
    public abstract void changeCaptureFormat(int width, int height, int frameRate);

    /**
     * 销毁
     */
    public abstract void dispose();


    @Override
    public IVideoCapturer asVideoCapturer() {
        return this;
    }


    /**
     * 外部调用，用于通知SDK外部是否已经成功开启视频数据提交
     *
     * @param success 是否成功开启
     */
    public void onCapturerStarted(boolean success) {
        VideoCapturerObserver observer = AVChatExternalVideoCapturer.super.getVideoCapturerObserver();
        if (observer != null) {
            observer.onCapturerStarted(success);
        }
    }


    /**
     * 外部调用，用于通知SDK外部已经停止视频数据提交
     */
    public void onCapturerStopped() {
        VideoCapturerObserver observer = AVChatExternalVideoCapturer.super.getVideoCapturerObserver();
        if (observer != null) {
            observer.onCapturerStopped();
        }
    }


    /**
     * 外部调用，用于提交每一帧视频数据
     *
     * @param data      视频数据
     * @param dataLen   视频数据宽度
     * @param width     视频数据高度
     * @param height    视频数据高度
     * @param rotation  视频画面旋转角度，为90度倍数，以顺时针为正方向
     * @param frameRate 输入的帧率，大于0，如果帧率过大，内部会做丢帧处理
     * @param format    视频数据格式 {@link AVChatImageFormat#I420}、{@link AVChatImageFormat#NV21}
     * @param timeStamp 视频帧时间戳，以{@link AVChatManager#enableRtc()}创建时刻为开始的基准时间，使用{@link SystemClock#elapsedRealtime()}即可
     * @param mirror    是否需要镜像，如果设置为{@code true}，在旋转之后进行
     * @return 视频帧数据是否提交成功，0成功，其他失败。
     * <p>-1-数据为空或长度不合法;
     * <p>-2-长宽不合法，如超过最大分辨率1920*1080或长宽和数据长度不匹配;
     * <p>-3-旋转角度不合法;
     * <p>-4-帧率不合法;
     * <p>-5-数据格式不合法;
     * <p>-10-其他错误;
     */
    public int onByteBufferFrameCaptured(byte[] data,
                                         int dataLen,
                                         int width,
                                         int height,
                                         int rotation,
                                         int frameRate,
                                         int format,
                                         long timeStamp,
                                         boolean mirror) {

        int ret = -10;
        VideoCapturerObserver observer = AVChatExternalVideoCapturer.super.getVideoCapturerObserver();

        if (data == null) {
            NimLog.e("AVChatExternalVideoCapturer", "data is null");
            return -1;
        }

        if (data.length < dataLen || VideoUtils.calcBufferSize(format, width, height) != data.length) {
            NimLog.e("AVChatExternalVideoCapturer", "Illegal data length!");
            return -2;
        }

        try {
            VideoFrame.Buffer buffer = VideoFrame.asBuffer(data, format, width, height);
            VideoFrame videoFrame = new VideoFrame(buffer, rotation, timeStamp);
            if (observer != null) {
                ret = observer.onFrameCaptured(videoFrame, frameRate, mirror);
            }

            videoFrame.release();
        } catch (IllegalAccessException e) {
            NimLog.e("AVChatExternalVideoCapturer", " onByteBufferFrameCaptured " + e);
        }

        return ret;
    }
}