短视频SDK

    拍摄器Android版本开发接入文档

    一、概述

    百度云短视频创作专注移动端视音频场景研发,提供端到端的一站式视音频技术解决方案,不限于采集、录制、合成、上传、存储、分发,极大降低客户接入音视频产品的技术门槛。

    1.1 注意事项

    运行环境

    • Android 4.1系统,API Level 16以上

    二、快速接入

    请先通过工单申请获取邀测资格,通过审批后会有专人联系您提供SDK源码包。

    解压SDK压缩包后将aar包放入项目libs目录:

    • 在项目build.gradle添加库依赖:
    repositories {
        flatDir {
            dirs 'libs'
        }
    }
    
    
    dependencies {
    
        api(name: 'multimedia-processor-release', ext: 'aar')
        api(name: 'aiphoto-v1.1', ext: 'aar')
    
    
        api 'com.baidu.minivideo:transcoder-sdk:1.0.2.156'
        api 'com.baidu.minivideo:core-armv5:1.0.2.156'
        api 'com.baidu.minivideo:core-armv7a:1.0.2.156'
        api 'com.google.code.gson:gson:2.8.5'
        api 'com.googlecode.mp4parser:isoparser:1.0.1'
        api 'com.googlecode.plist:dd-plist:1.16'
    }
    • 在使用拍摄器SDK,需要申请产品对应的授权文件,如无授权,产品无法正常使用。
    • 申请成功后,会得到一个licenseID和对应授权文件下载地址,用户下载成功后,需要手动添加到项目工程中

    注意:授权文件后缀名为.license。

    三、接口使用说明

    3.1 录制设置

    • 录制的相关接口是在com.baidu.ugc.record.RecordManager类里,包括录制、美颜、贴纸和滤镜

    3.1.1 初始化接口

    设置预览画面

    void setGLSurfaceView(GLSurfaceView view)

    初始化录像机

    void init(RecordManager.ICamera cameraManager, int cameraFrameRate, int videoBitrate, boolean isCameraFront, java.lang.String outputDir, java.lang.String arDataPath)

    数据加载

    void loadData(RecordManager.OnDataLoadCallback listener)

    注意:在实例化new RecordManager(this, appid)需要传人appid即用户申请的licenseID,若未申请授权,请参考快速接入

    3.1.2 生命周期方法

    一般的生命周期为:初始化 -> resume -> pause -> destroy

    停止预览,一般在在Activity的onStop时调用

    void    pause()

    开始预览,一般在Activity的onStart时调用

    void    resume()

    对象销毁,销毁后需要重新创建对象

    void    destroy()

    3.1.3 相机设置

    获取到摄像头的状态

    boolean isFrontCamera()

    相机的当前摄像头是否正在处于预览中

    boolean isPreviewing()

    设置前后摄像头

    protected void  setCameraFace(boolean front)

    相机尺寸,默认720P,如果摄像头不支持,那么会取相近比例的尺寸

    void    setCameraSize(int w, int h)

    相机切换前后摄像头

    void    switchCamera()

    3.1.4 录制与停止录制

    获取当前录制视频的完整路径

    String    getVideoAbsoluteFile()

    是否为正在录制

    boolean isRecording()

    设定视频输出目录

    boolean setVideoPath(java.lang.String videoFileDir)

    开始录制

    boolean startRecording()

    停止录制

    boolean stopRecording()

    3.2 美颜设置

    美颜设置接口,代码示例如下:

    调整美颜程度

    void setBeauty(float v) //参数0.0f不美颜

    调整美白程度

    void setBeautyWhite(float value)

    调整磨皮程度

    void setBeautyBlure(float value)

    调整大眼程度

    void    setEnlargeEye(float value)

    调整瘦脸程度

    void    setCheekThin(float value)
    • 注意:使用高级美颜时,需要申请对应权限,免费版本不支持此功能

    3.3 滤镜设置

    设置滤镜

    void setFilter(Filter filter)

    滤镜参数

    void setFilterLevel(float v)

    3.4 贴纸设置

    设置贴纸道具

    void setStickerEffect(Sticker sticker, java.lang.String tabName)

    下载贴纸

    • 【v3.0】版本后,贴纸采用后下载方式使用,开通license的同时可以在Console购买或选择贴纸信息;
    • 使用贴纸涉及两个接口,获取贴纸列表信息、贴纸文件下载使用。

    一、获取贴纸列表信息,即用于产品贴纸展示,建议开发者提前获取贴纸列表,可缓存,减少用户等待。下方获取贴纸列表数据实例代码:

    1:调用加载贴纸列表数据

    相关类:com.baidu.smartminivideo.capture.sticker.helper.LoadSticker
    
    
    public void loadStickerDatas() {
        String appId = Config.LICENSE_APPID;
        String sdkVersion = Config.sdkVersion;
        DownStickerHelper loadStickerHelper = new DownStickerHelper(SmartminivideoApplication.getContext(),
                appId, sdkVersion);
        loadStickerHelper.loadStickerList(this);
    }

    2:在第一步调用之后,会回调两个方法,将贴纸数据字符串传输回来

    成功回调:
    @Override
    public void onListSuccess(String stickerList) {}
    
    
    失败回调:
    @Override
    public void onFail(String msg) {}

    二、贴纸文件下载使用。即用户选择某个贴纸后,下载贴纸并且加载使用。
    注:部分贴纸还会涉及模型下载,见下方示例代码:

    1:调用加载单个贴纸数据

    相关类:com.baidu.smartminivideo.capture.sticker.helper.LoadSticker
    
    public void loadOneSticker(String faceId) {
        String appId = Config.LICENSE_APPID;
        String sdkVersion = Config.sdkVersion;
        DownStickerHelper loadStickerHelper = new DownStickerHelper(SmartminivideoApplication.getContext(),
                appId, sdkVersion);
        loadStickerHelper.loadOneStickerList(Long.parseLong(faceId), this);
    }

    2:在第一步调用之后,会回调两个方法,将单个贴纸数据字符串传输回来

    成功回调:
    @Override
    public void onOneSuccess(String sticker) {}
    
    失败回调:
    @Override
    public void onFail(String msg) {}

    3:在第3步回调之后,若成功获取单个贴纸数据,则将继续下载贴纸文件,见下方实例代码:

    具体可查看demo工程中相关类:
    com.baidu.smartminivideo.capture.sticker.StickerAdapter
    com.baidu.smartminivideo.capture.beautify.StickerDownloadManager
    
    
    StickerDownloadManager.download(item, new StickerDownloadManager.OnStickerDownloadCallback<FuFaceItem>() {
            @Override
            public void onStarted(FuFaceItem tag) {
                holder.startLoadingAnim();
            }
    
            @Override
            public void onProgress(FuFaceItem tag, long finished, long total, int progress) {
    
            }
    
            @Override
            public void onCompleted(FuFaceItem faceItem) {
                if (mLastClickIndex != position) {
                    notifyDataSetChanged();
                    return;
                }
                mSelectedIndex = position;
                notifyDataSetChanged();
                if (mListener != null) {
                    mListener.onSelectSticker(item, faceItem.getFilePath());
                }
            }
    
            @Override
            public void onFailed(FuFaceItem faceItem, int what, int ext, String msg) {
                Log.e("StickerAdapter", "onFailed:" + faceItem.name
                        + ", what:" + what + ", ext:" + ext + ", msg:" + msg);
                notifyDataSetChanged();
            }
        });
    }