Android拍摄 SDK开发文档

Android拍摄 SDK简单介绍

智汇云以SDK形式提供视频拍摄采集，可以帮助开发者快速实现视频拍摄能力。SDK包括开发文档、开发demo、SDK
JAR文件以及SO库文件。开发者可参考文档或demo，将JAR文件和SO文件加入APP的工程中，完成相关配置，调用相关的API即可完成Android的音视频直播采集录制服务。

功能说明：

SDK集成方法介绍：

下载Demo工程

从这里下载 SDK Demo。

下载SDK

• jar：qhvc_shoot_sdk.jar
• so: armeabi-v7a/libvsshoot.so

Demo工程结构及配置说明

demo: 示例工程，演示本SDK主要接口功能的使用

libs/[armeabi-v7a|arm64-v8a|x86]: 各平台的so库

libs/qhvc_shoot_sdk.jar: 拍摄SDK jar包

src/main/assets/videorecord/shader 滤镜功能用到的资源文件

配置说明

videosdk_recorder.jar放到工程libs目录下，在build.gradle中配置：

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
}

将下载的.so放到工程src/main/jniLibs/armeabi-v7a/目录下，在build.gradle中配置：

android {
    defaultConfig {
        ndk {
            // 设置支持的CPU架构，目前只支持armeabi-v7a架构（该架构兼容armeabi、arm64-v8a、x86、x86_64架构）
            abiFilters 'armeabi-v7a'
        }
    }
}

权限配置

在AndroidManifest.xml文件中申请相应权限：

<uses-permission android:name="android.permission.MOUNT_FORMAT_FILESYSTEMS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.RECORD_VIDEO"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.CAMERA"/>
<uses-feature android:glEsVersion="0x00020000" android:required="true"/>
<uses-feature android:name="android.hardware.camera"/>
<uses-feature android:name="android.hardware.camera.autofocus"/>
<uses-permission android:name="android.permission.READ_LOGS"/>
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>

SDK接口使用流程说明：

接口调用流程图

初始化拍摄类

recordKit = new QHVCRecordKit(this);
recordKit.setOrientation(QHVCRecordConstants.Orientation.ORIENTATION_PORTRAIT);

设置拍摄推流参数

视频相关参数

videoRecordConfig = new QHVCVideoRecordConfig.Builder().setVideoWidth(360).setVideoHeight(640).build();

音频相关参数

audioRecordConfig = new QHVCAudioRecordConfig.Builder().setSampleRate(QHVCRecordConstants.RecordAudioSampleRate.audio_sample_22050HZ).build());

设置音视频参数

recordKit.initRecordConfing(videoRecordConfig,audioRecordConfig);

设置保存路径及录制回调信息

  recordKit.setRecordSavePath(videoPath, videoSegmentFolder, new QHVCRecordCallBack() {
            @Override
            public void onstart(int recordId) {
                RecordLogger.i(TAG, TAG + "setRecordSavePath:onstart()" + recordId);
                recordTime = 0;
                if (recordKit != null) {
                    SegmentInfo segmentInfo = new SegmentInfo();
                    recordKit.getRecordInfo(recordId, segmentInfo);
                    RecordLogger.i(TAG, TAG + "setRecordSavePath:onstart():segmentInfo:" + segmentInfo.toString());
                }
            }
            @Override
            public void onProcess(int recordId, long duration) {
                RecordLogger.i(TAG, TAG + "setRecordSavePath:onProcess():---recordId:" + recordId
                        + "----duration:" + duration);
                recordTime = (int) duration;
            }
            @Override
            public void onStop(int recordId, long duration, int errorCode) {
                RecordLogger.i(TAG, TAG + "setRecordSavePath:onStop()：---recordId" + recordId+"----duration:" + duration);
                recordTotalTime = recordTotalTime + (int)duration;
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        if(deleteLastPath.get()){
                            deleteLastReocord();
                            deleteLastPath.set(false);
                        }
                        recordSeekBar.setProgress(recordTotalTime);
                    }
                });
                recordTime = 0;
            }
            @Override
            public void onError(int errorCode, final String message) {
                RecordLogger.e(TAG, TAG + "setRecordSavePath:onError()：---errorCode" + errorCode + ",message:" + message);
                switch (errorCode) {
                    case ERROR_CODE_SEND_VIDEO_DATA:
                    case ERROR_CODE_SEND_AUDIO_DATA:
                        runOnUiThread(new Runnable() {
                            @Override
                            public void run() {
                                Toast.makeText(RecordActivity.this, message, Toast.LENGTH_LONG).show();
                                if (isRecord.get()) {/*先停止拍摄*/
                                    deleteLastPath.set(true);
                                    startOrStopRecord();
                                }
                                deleteLastReocord();
                            }
                        });
                        break;
                }
            }

设置视频数据回调

        recordKit.setVideoDataCallBack(new QHVCVideoDataCallBack() {
            @Override
            public void onRawData(byte[] recordData, int width, int height) {
                //                RecordLogger.i(TAG,TAG+"Video：onRawData()：---recordData"+recordData.length);
                if(beautyShader!=null){
                    beautyShader.catchPoints(recordData,recordKit.isUseFrontCamera()?
                            Camera.CameraInfo.CAMERA_FACING_FRONT:Camera.CameraInfo.CAMERA_FACING_BACK,width,height);
                }
            }
            @Override
            public void onPostData(SurfaceTexture surfaceTexture) {
            }
            @Override
            public void onEncodeData(byte[] recordData, int length, long pts, int frameType) {
                //                RecordLogger.i(TAG,TAG+"Video：onEncodeData()：---recordData"+recordData.length);
            }
            @Override
            public void onYUVonPostData(byte[] yData, int yStride, byte[] uData, int uStride, byte[] vData, int vStride, long pts, int frameType) {
                //                RecordLogger.i(TAG,TAG+"Video：onYUVonPostData()：---yData:"+yData.length);
            }
        });

设置音频数据回调

 recordKit.setAudioDataCallback(new QHVCAudioDataCallBack() {
            @Override
            public void onRawData(byte[] recordData, int length, int datatype) {
            }
            @Override
            public void onEncodeData(byte[] recordData, int length, int pts) {
            }
        });

设置预览View

recordKit.setDisplayPreview(surfaceview);

编码方式

 recordKit.setEncodeMethod(QHVCRecordConstants.EncodeMethod.ENCODE_HARDWARE);

开启预览

recordKit.startPreview();

开始录制

recordKit.startRecord();

停止录制

recordKit.stopRecord();

删除最后分段视频

recordKit.deleteLastPath();

删除最后N秒

recordKit.deleteLastSegmentByMS(deleteTime)；

加入自定义效果

 recordKit.addShader(GPVideoRecorderShaderType.Shader[shaderSelect], 0);

切换摄像头

 recordKit.switchCameraFacing();

开启闪光灯

 recordKit.openFlashLight(flashLightOpen);

设置倍速

recordKit.setRecordSpeed(Float.parseFloat(speed));

设置静音

recordKit.setMute(true);

合成多段视频

    recordKit.joinAllSegment(new QHVCJoinRecordCallBack() {
        @Override
        public void onStart() {
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    joinProcessDialog();
                }
            });
        }
        @Override
        public void onProcess(final float process) {
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    if (mExitDialog != null && mExitDialog.isShowing()) {
                        DecimalFormat decimalFormat = new DecimalFormat(".0");//构造方法的字符格式这里如果小数不足2位,会以0补足.
                            String p = decimalFormat.format(process);//format 返回的是字符串
                            mExitDialog.setMsgText("当前进度:" + p + "%");
                        }
                    }
                });
            }
        @Override
        public void onFinish(final SegmentInfo[] segmentInfos, final RecordFileInfo recordFileInfo) {
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    Logger.e(TAG,"SegmentInfos:"+ Arrays.toString(segmentInfos)+
                        ",--recordFileInfo:"+recordFileInfo.toString()+",--totleTime:"+recordTotalTime);
                    insertVideoToMediaStore(RecordActivity.this, videoPath, System.currentTimeMillis(), videoRecordConfig.getVideoWidth(), videoRecordConfig.getVideoHeight(),
                                recordTotalTime);
                        if (mExitDialog != null && mExitDialog.isShowing()) {
                            mExitDialog.dismiss();
                        }
                        Intent intent = new Intent(RecordActivity.this, ShowCombineRecordActivity.class);
                        intent.putExtra("videoPath", videoPath);
                        startActivity(intent);
                        finish();
                }
            });
        }
        @Override
        public void onError() {
            RecordLogger.i(TAG, TAG + "joinAllSegment：onError()");
        }
        @Override
        public void onCancel() {
        }
    });

取消合成

recordKit.cancelJoin();

释放资源

recordKit.release();

更多详细接口请参考API接口文档及Demo

错误信息

sdk文件日志

为便于接入时定位问题，在开发版本中已记录关键日志，推流相关的日志TAG为”QHVCRecordKit”。

打包混淆

-keepclasseswithmembernames class * {
    native <methods>;
}
-keep class com.qihoo.livecloud.recordkit.** {
    <fields>;
    <methods>;
}