美摄SDK For Android  2.5.0.22
详细开发引导

详细内容

1 概述

美摄SDK致力于解决移动端视频开发的技术门槛,使仅有android界面开发经验的程序员,都可以开发出性能优异、渲染效果丰富的的视频录制、编辑功能。我们的优势体现在:

1.1 支持格式

1.2 注意事项

1.2.1 限制

美摄SDK的所有接口必须在UI线程调用,否则可能出现无法预料的错误。只有NvsVideoFrameRetriever类的getFrameAtTime()方法除外。

1.2.2 运行环境

运行环境如下:android studio(必须),android4.1以上版本,api 16

1.2.3 重要提示

目前,安卓仅提供armeabi-v7a指令集的包。这里会产生个问题,部分其他第三方的SDK可能会提供多个指令集so,若此时第三方的客户使用64位的手机,且该应用带64位的so的时候,在loadLibrary时会出现找不到so的错误。 关于指令集的官方文档如下:https://developer.android.com/ndk/guides/abis.html?hl=is,此链接需要翻墙才可成功。目前SDK提供的指令集:armeabi-v7a,仅提供这个版本是因为这个版本就能够兼容。 为什么报错呢?原因是用户使用的其他第三方包提供了别的指令集的的包,导致比如64位的手机会去找arm64-v8a的包。 这里建议:其他第三方包全部使用armeabi-v7的包。操作方式是在gradle命令行加入

        defaultConfig { 
            ndk {
            abiFilters "armeabi-v7a"
            } 
        }

最后:如何查看打的包打入了so呢? 最简单的方法是使用解压工具将apk后缀修改为.zip,直接查看libs里面的so是否打入。

2 快速接入

2.1 导入库文件

如果没有SDK,请从美摄官网:https://www.meishesdk.com/doc下载最新andriod开发版本。导入库文件的方式有两种:
方式一: 直接复制。
创建工程后,将NvStreamingSdk_Android_***_***\lib\android_jar文件夹里的两个jar包(NvAndroidStreamingSdk.jar和QtAndroid-bundled.jar),复制到工程的libs文件夹下。 同时在工程的jniLibs文件夹下(没有就创建同名文件夹),创建文件夹名为armeabi-v7a。将NvStreamingSdk_Android_***_***\lib\android_armv7里的所有.so文件,复制到刚刚创建的armeabi-v7a文件夹里。

loadLibrary.png


方式二:通过配置gradle命令行方式导入库。
美摄SDK的samples都是通过配置命令行的方式导入库文件。红线的代码用于将.so和jar包复制到正确的位置。

loadLibrary2.png

3 使用说明

3.1 录制

录制的相关接口是在NvsStreamingContext类里,包括采集预览(startCapturePreview()),录制(startRecording()),添加视频采集特效(appendBuiltinCaptureVideoFx())等。强调:美摄SDK所有的类都是以“Nvs”开头。
视频录制时需要注意以下两点:

如果查看录制视频的具体功能实现,建议参考samples里的capture示例,美颜可以参考samples里的beauty示例。

3.1.1 从CaptureDeviceCallback接口派生

录制前,录制的Activity需要实现NvsStreamingContext类的CaptureDeviceCallback接口并重写接口里的所有方法。实现代码如下:

        //采集设备回调接口
        public class MainActivity extends AppCompatActivity implements NvsStreamingContext.CaptureDeviceCallback {
            ......//请自行重写所有方法
        }

3.1.2 NvsStreamingContext类

NvsStreamingContext是美摄SDK的流媒体上下文类,可视作整个SDK框架的入口。在开始使用美摄SDK的时候,需要先初始化NvsStreamingContext类,然后在其它Activity里使用时 获取NvsStreamingContext的对象,NvsStreamingContext是单例类。在不再使用美摄SDK或者程序退出前销毁NvsStreamingContext类的对象,请务必保证不要中途销毁NvsStreamingContext 类的对象!!!NvsStreamingContext类的第二个参数为授权文件的路径,没有授权文件时给空字符串。
NvsStreamingContext初始化代码如下:

        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            m_streamingContext = NvsStreamingContext.init(this, null);//初始化Streaming Context
            setContentView(R.layout.activity_main);
        }

NvsStreamingContext销毁代码如下:

        @Override
        protected void onDestroy() {
            //streamingContext销毁
            m_streamingContext = null;
            NvsStreamingContext.close();
        }

3.1.3 用NvsLiveWindow类预览

录制界面的xml文件里需要使用NvsLiveWindow控件,NvsLiveWindow类是用来录制预览或者编辑预览的。xml文件设置如下:

        <com.meicam.sdk.NvsLiveWindow
            android:layout_height="match_parent"
            android:id="@+id/liveWindow"
            android:layout_width="match_parent" 
        />

NvsLiveWindow的宽高比应该是1:1,4:3,16:9,9:16等,最好与采集预览startCapturePreview()的参数aspectRatio值保持一致。否则,预览的图像是录制完的视频被裁剪后的图像。 用户设置宽高比,可通过派生NvsLiveWindow类来实现自定义宽高比,代码请参考samples示例edit中的LiveWindow.java。 NvsLiveWindow的填充模式:

        public class NvsLiveWindow extends SurfaceView implements SurfaceHolder.Callback
        {
            //图像按比例均匀填充,必要时进行裁剪(默认模式)   
            public static final int FILLMODE_PRESERVEASPECTCROP = 0;
            //图像均匀地缩放来适合窗口,没有裁剪
            public static final int FILLMODE_PRESERVEASPECTFIT = 1;
            //图像被缩放来适合窗口
            public static final int FILLMODE_STRETCH = 2;
        }

对于三种填充模式,图片展示如下:

另一种预览方式是通过与SurfaceTexture连接,在SurfaceView上预览显示。对应接口如下:

        //连接时间线和一个SurfaceTexture对象,该时间线的渲染结果将会输出到这个SurfaceTexture对象上面
        public boolean connectTimelineWithSurfaceTexture(NvsTimeline timeline, SurfaceTexture outputSurfaceTexture)

        //连接时间线和一个SurfaceTexture对象并设置代理级别,该时间线的渲染结果将会输出到这个SurfaceTexture对象上面
        public boolean connectTimelineWithSurfaceTexture(NvsTimeline timeline, SurfaceTexture outputSurfaceTexture, NvsRational proxyScale)

3.1.4 预览前的准备

        //给Streaming Context设置采集设备回调接口(必须有)
        m_streamingContext.setCaptureDeviceCallback(this);
        if (m_streamingContext.getCaptureDeviceCount() == 0)
            return;
        // 将采集预览输出连接到NvsLiveWindow控件(必须有)
        if (!m_streamingContext.connectCapturePreviewWithLiveWindow(m_liveWindow)) {
            Log.e(TAG, "Failed to connect capture preview with livewindow!");
            return;
        }
        //采集设备数量判定,如果采集设备是1,不能开启前置摄像头。
        if (m_streamingContext.getCaptureDeviceCount() > 1)
            m_switchBackFacing.setEnabled(true);

        if (m_streamingContext.isCaptureDeviceBackFacing(0))//判断是否为后置采集设备
        {
            .....
        }

3.1.5 开启预览

在启动视频录制之前,要进行视频采集预览。

        //启动采集预览
        m_streamingContext.startCapturePreview(m_currentDeviceIndex, NvsStreamingContext.VIDEO_CAPTURE_RESOLUTION_GRADE_SUPER_HIGH, 0, m_aspectRatio);

3.1.5.1 带美颜录制和不带美颜录制

采集预览时,可以在预览画面上看到添加的美颜和滤镜。在录制的时候,如果开启带特效录制,录制好的文件是带有美颜和滤镜的画面。如果不开启,则录制好的视频文件没有美颜和滤镜效果, 可以在后续的编辑功能中,再添加美颜和滤镜。若要带特效录制,则startCapturePreview()的flags参数值必须设为NvsStreamingContext.STREAMING_ENGINE_CAPTURE_FLAG_DONT_USE_SYSTEM_RECORDER,否则设为0。
更多请参考:https://www.meishesdk.com/doc_ch/html/content/videoRecorderMode.md.html

3.1.6 录制与停止录制

录制时,文件名是.mov则录制mov格式文件,如果是.mp4则录制mp4格式文件。

        m_streamingContext.startRecording(file.getAbsolutePath());//开始录制
        m_streamingContext.stopRecording();//停止录制

录制startRecording()的参数outputFilePath是录制视频文件的路径。停止视频录制直接调用stopRecording()即可。

3.1.7 录制参数调节

切换闪光灯:

        m_streamingContext.toggleFlash(isChecked);

自动聚焦:

        m_streamingContext.startAutoFocus(new RectF(rectFrame));//启动自动聚焦
        m_streamingContext.cancelAutoFocus();//取消自动聚焦

设置缩放:

        m_streamingContext.setZoom(0.8);// 设置缩放值为0.8

3.1.8 美颜

添加美颜特效后,在预览窗口是可以看到美颜效果的。录制视频时,用户需要根据手机性能任意选择带美颜录制或者不带美颜录制方式。美颜特效参数Strength与Whitening分别对应磨皮与美白,Samples的beauty示例的所给值即推荐值。

        NvsFxDescription fxDescription = m_streamingContext.getVideoFxDescription("Beauty");//获取美颜特技描述信息
        List<NvsFxDescription.ParamInfoObject> paramInfo =  fxDescription.getAllParamsInfo();//获取描述的所有参数信息
        for (NvsFxDescription.ParamInfoObject param:paramInfo) {
            String paramName = param.getString("paramName");
            if (paramName.equals("Strength")) {
                double maxValue = param.getFloat("floatMaxVal");//获取美颜磨皮最大值
                m_strengthValue = param.getFloat("floatDefVal");//获取美颜磨皮当前值
            }
        }

        NvsCaptureVideoFx fx = m_streamingContext.appendBeautyCaptureVideoFx();//添加美颜采集特效
        fx.setFloatVal("Strength", m_strengthValue);//设置美颜磨皮值
        fx.setFloatVal("Whitening", m_whiteningValue);//设置美白强度值

3.1.9 采集特效(滤镜)

采集特效分为两种,内建采集特效和扩展采集特效,扩展采集特效即通过资源包安装而得到的采集特效。资源包包括主题包,字幕样式包,动画贴纸包,转场包,滤镜包等。

3.1.9.1 内建采集特效

内建采集特效名称列表可以参考:https://www.meishesdk.com/doc_ch/html/content/FxNameList.md.html。
添加与移除特效:

        //获取所有内建采集特效的名称
        m_streamingContext.getAllBuiltinCaptureVideoFxNames();

        //添加内建采集特效
        m_streamingContext.appendBuiltinCaptureVideoFx(fxName);
        //移除所有采集视频特效
        m_streamingContext.removeAllCaptureVideoFx();

3.1.9.2 扩展采集特效

添加扩展采集特效时,首先需要安装扩展采集特效所对应的资源包,获取资源包对应的包ID值,然后才可添加扩展采集特效。

        //安装一个视频采集特效包,此处采用同步安装方式,如果资源包尺寸太大或者根据需要可使用异步安装方式
        String package1Path = "assets:/7FFCF99A-5336-4464-BACD-9D32D5D2DC5E.videofx";
        m_fxPackageId = new StringBuilder();
        int error = m_streamingContext.getAssetPackageManager().installAssetPackage(package1Path, null, NvsAssetPackageManager.ASSET_PACKAGE_TYPE_VIDEOFX, true, m_fxPackageId);
        if (error != NvsAssetPackageManager.ASSET_PACKAGE_MANAGER_ERROR_NO_ERROR
                && error != NvsAssetPackageManager.ASSET_PACKAGE_MANAGER_ERROR_ALREADY_INSTALLED) {
            Log.e(TAG, "Failed to install asset package!");
        }

        //添加扩展采集特效
        m_streamingContext.appendPackagedCaptureVideoFx(m_fxPackageId.toString());

3.2 编辑

实现视频编辑的一般步骤:

视频编辑里包含播放和生成视频,所以编辑的Activity需要实现两个回调接口及其对应的所有方法。实现代码:

        //CompileCallback 生成回调接口
        //PlaybackCallback 播放回调接口
        public class MainActivity extends AppCompatActivity implements NvsStreamingContext.CompileCallback,
        NvsStreamingContext.PlaybackCallback{
            ......//请自行重写所有方法
        }

编辑功能的具体实现请参考samples里面的edit。Mediapicker这个module是第三方的代码,用来从手机里选取图片和视频文件的,与美摄SDK无关。

3.2.1 创建timeline设定视频尺寸

创建timeline对于编辑是非常关键的,timeline的分辨率决定了生成视频文件的最大分辨率(尺寸)。请将timeline的分辨率和NvsLiveWindow的宽高比适配一致。

        NvsVideoResolution videoEditRes = new NvsVideoResolution();
        /*
            注意:请在使用LiveWindow预览的时候,将NvsLiveWindow的宽高比与此处保持一致。
        */
        videoEditRes.imageWidth = 1280; /*视频分辨率的宽*/
        videoEditRes.imageHeight = 720; /*视频分辨率的高*/
        videoEditRes.imagePAR = new NvsRational(1, 1); /*像素比,设为1:1*/
        NvsRational videoFps = new NvsRational(25, 1); /*帧速率,代表1秒播出多少帧画面,一般设25帧,也可设为30 */

        NvsAudioResolution audioEditRes = new NvsAudioResolution();
        audioEditRes.sampleRate = 44100; /*音频采样率,可以是44100,或者48000*/
        audioEditRes.channelCount = 2; /*音频通道数,一般是2*/

        /*创建时间线*/
        m_timeline = m_streamingContext.createTimeline(videoEditRes, videoFps, audioEditRes);
        //将timeline连接到LiveWindow控件
        m_streamingContext.connectTimelineWithLiveWindow(m_timeline,m_liveWindow);
        m_streamingContext.setCompileCallback(this);//设置生成回调接口
        m_streamingContext.setPlaybackCallback(this);//设置播放回调接口

3.2.2 多段视频、图片混编

创建视频轨道,一般情况下是创建一条视频轨道。创建完轨道之后,往轨道上添加图片或者视频素材。添加到轨道上的素材,我们称它为片段(clip)。图片和视频素材都是 通过文件路径添加到轨道上的。唯一的区别是图片素材如果尺寸过大,需要降低图片尺寸,降低尺寸后的图片和创建timeline的分辨率的尺寸大小匹配最好。

        /*添加视频轨道,如果不做画中画,添加一条视频轨道即可*/
        m_videoTrack = m_timeline.appendVideoTrack();
        //通过素材文件路径添加素材,可以是图片或者视频
        for(int i = 0; i < pathList.size(); i++) {
            /*
                添加片段到轨道上,建议判断返回值查看片段是否添加成功
            */
            NvsVideoClip clip = m_videoTrack.appendClip(pathList.get(i));
        }

3.2.3 播放与定位预览

对于播放与定位预览接口,其参数videoSizeMode建议设置为NvsStreamingContext.VIDEO_PREVIEW_SIZEMODE_LIVEWINDOW_SIZE。若无特殊需求,设为NvsStreamingContext.VIDEO_PREVIEW_SIZEMODE_FULLSIZE的模式会影响性能。 preload是预加载,设为true。美摄SDK的时间单位是微秒,1/1000000秒。
视频播放:

        //playbackTimeline()的参数endTime,值可以是_timeline.duration或者-1
        m_streamingContext.playbackTimeline(m_timeline, m_streamingContext.getTimelineCurrentPosition(m_timeline), -1, NvsStreamingContext.VIDEO_PREVIEW_SIZEMODE_LIVEWINDOW_SIZE, true, 0);

视频定位预览:

        m_streamingContext.seekTimeline(m_timeline, 0, NvsStreamingContext.VIDEO_PREVIEW_SIZEMODE_LIVEWINDOW_SIZE, 0);

3.2.4 视频裁剪

        NvsVideoClip clip = m_videoTrack.getClipByIndex(m_currentPosition);
        /*
            改变片段的入出点,裁剪片段。第二个参数请设置为true。
        */
        clip.changeTrimInPoint((long)trim_in, true);
        clip.changeTrimOutPoint((long)trim_out, true);

3.2.5 从轨道上移除片段

        //clipIndex代表轨道上片段的位置,keepSpace请填false。
        m_videoTrack.removeClip(0, false);

3.2.6 片段排序

轨道上的片段可以互换位置。

        /*
            clipIndex和destClipIndex分别代表互换的两个素材的位置索引
        */
        m_videoTrack.moveClip(0,3);

3.2.7 图片时长设定

NvsVideoTrack类提供appendClip(String filePath, long trimIn, long trimOut)可以根据需要自由设定图片时长。同样,添加的是视频,亦可如此设置。

        /*
            追加片段,filePath是图片素材的路径,trimIn设置0,trimOut设置为8000000,则图片显示为8秒。
        */
        m_videoTrack.appendClip(pathList.get(i),0,8000000); 

如果通过appendClip(String filePath)这个方法添加的图片,则图片默认显示时长是4秒。

3.2.8 移除时间线与轨道

在程序退出时,要对创建的时间线,添加的视频轨道和音频轨道进行移除。操作如下:
移除时间线:

        //移除时间线
        m_streamingContext.removeTimeline(m_timeline);

移除视频轨道:

        // 移除指定索引值的视频轨道
        m_timeline.removeVideoTrack(0);

移除音频轨道:

        // 移除指定索引值的音频轨道
        m_timeline.removeAudioTrack(0);

3.3 音乐

3.3.1 添加音乐

给视频添加音乐是通过添加一条音频轨道实现的。创建时间线后,通过appendAudioTrack()添加一条音频轨道,然后把音乐的文件添加到音频轨道上,可以添加多段音乐,音乐会连续播放。

        //添加音频轨道
        m_audioTrack =  m_timeline.appendAudioTrack();
        /*
            filePath是音频文件的路径。支持的格式见1.1功能特点。
        */
        m_audioTrack.appendClip(pathList.get(i));

3.3.2 音乐裁剪

音乐裁剪与视频裁剪是一样的,也是通过设置入出点的方式进行裁剪。

        NvsAudioClip clip = m_audioTrack.getClipByIndex(m_currentPosition);
        /*
            改变片段的入出点,裁剪片段。第二个参数请设置为true。
        */
        clip.changeTrimInPoint((long)trim_in, true);
        clip.changeTrimOutPoint((long)trim_out, true);  

3.4 字幕

字幕添加可以参考samples里面caption这个示例。在时间线(timeline)上可以添加,删除以及获取字幕。

3.4.1 添加与删除字幕

添加字幕:

         // 在时间线上添加字幕,返回添加的字幕对象
         NvsTimelineCaption m_timelineCapion = m_timeline.addCaption("美摄SDK", 0, m_timeline.getDuration(), null);

移除字幕:

        //移除时间上的字幕,返回下一个时间线字幕对象
         NvsTimelineCaption nextCaption = m_timeline.removeCaption(m_timelineCapion);

3.4.2 获取timeline上的字幕

获取字幕各个接口如下:

        //获得时间线上的第一个字幕
        public NvsTimelineCaption getFirstCaption()

        //获得时间线上的最后一个字幕
        public NvsTimelineCaption getLastCaption()

        //获得时间线上的当前字幕的前一个字幕
        public NvsTimelineCaption getPrevCaption(NvsTimelineCaption caption)

        //获得时间线上的当前字幕的后一个字幕
        public NvsTimelineCaption getNextCaption(NvsTimelineCaption caption)

        /*
            根据时间线上的位置获得字幕,返回保存当前位置字幕的List集合。获取的字幕列表排序规则如下:
            1.添加时字幕入点不同,按入点的先后顺序排列;
            2.添加时字幕入点相同,按添加字幕的先后顺序排列。
        */
        public List<NvsTimelineCaption> getCaptionsByTimelinePosition(long timelinePos)

3.4.3 改变字幕的属性

字幕属性的设置都是在NvsTimelineCaption类里实现的。获取字幕之后,即可设置下列属性。

        //设置字幕文本
        public void setText(String text)
        //获取字幕文本
        public String getText()

        //设置字幕字体加粗
        public void setBold(boolean bold)
        //获取字幕字体加粗状态
        public boolean getBold()

        //设置字幕字体斜体
        public void setItalic(boolean italic)
        //获取字幕斜体状态
        public boolean getItalic()

        //设置字幕文本颜色
        public void setTextColor(NvsColor textColor)
        //获取字幕字体的当前颜色值
        public NvsColor getTextColor()

        //设置字幕描边
        public void setDrawOutline(boolean drawOutline)
        //获取字幕描边状态
        public boolean getDrawOutline()

        //设置字幕描边的颜色
        public void setOutlineColor(NvsColor outlineColor)
        //获取当前字幕描边的颜色值
        public NvsColor getOutlineColor()

        //设置字幕描边的宽度
        public void setOutlineWidth(float outlineWidth)
        //获取当前字幕描边的宽度
        public float getOutlineWidth()

        //设置字幕阴影
        public void setDrawShadow(boolean drawShadow)
        //获取当前字幕阴影状态
        public boolean getDrawShadow()

        //设置字幕阴影的颜色
        public void setShadowColor(NvsColor shadowColor)
        //获取当前字幕阴影的颜色
        public NvsColor getShadowColor()

        // 设置字幕阴影的偏移量
        public void setShadowOffset(PointF shadowOffset)
        //获取当前字幕阴影的偏移量
        public PointF getShadowOffset()

        //设置字幕字体大小
        public void setFontSize(float fontSize)
        //获取当前字幕的字体大小
        public float getFontSize()

        //设置字幕字体
        public void setFontByFilePath(String filePath)      
        //字幕平移
        public void setCaptionTranslation(PointF translation)

如果是全景图字幕,则需要设置下列属性:

        //对字幕设置中心点的极角。
        public void setCenterPolarAngle(float centerPolarAngle)
        //对字幕设置中心点的方位角。
        public void setCenterAzimuthAngle(float centerAzimuthAngle)
        //对字幕设置极角的张角。
        public void setPolarAngleRange(float polarAngleRange)

3.4.4 改变字幕的入出点

        //获取字幕在时间线上显示的入点
        public long getInPoint()

        //获取字幕在时间线显示上的出点
        public long getOutPoint()

        //改变字幕在时间线上显示的入点
        public long changeInPoint(long newInPoint)

        //改变字幕在时间线上显示的出点
        public long changeOutPoint(long newOutPoint)

        //改变字幕在时间线上的显示位置(入点和出点同时偏移offset值)
        public void movePosition(long offset)   

3.5 动画贴纸

添加,删除以及获取动画贴纸也是在时间线(timeline)上进行操作的。

3.5.1 添加与删除动画贴纸

        //添加动画贴纸
        m_timeline.addAnimatedSticker(0, m_timeline.getDuration(), m_stickerId.toString());

        // 移除动画贴纸,返回当前贴纸的下一下贴纸
        NvsTimelineAnimatedSticker sticker = m_timeline.getFirstAnimatedSticker();
        m_timeline.removeAnimatedSticker(sticker);

3.5.2 获取timeline上的动画贴纸

时间线上有多个接口用来获取添加的动画贴纸。

        //获取时间线上第一个动画贴纸
        public NvsTimelineAnimatedSticker getFirstAnimatedSticker()
        //获取时间线上最后一个动画贴纸
        public NvsTimelineAnimatedSticker getLastAnimatedSticker()
        //获取时间线当前动画贴纸的前一个动画贴纸
        public NvsTimelineAnimatedSticker getPrevAnimatedSticker(NvsTimelineAnimatedSticker animatedSticker)
        //获取时间线当前动画贴纸的后一个动画贴纸
        public NvsTimelineAnimatedSticker getNextAnimatedSticker(NvsTimelineAnimatedSticker animatedSticker)
        /*
            根据时间线上的位置获得动画贴纸,返回保存当前位置动画贴纸对象的List集合
            获取的动画贴纸列表排序规则如下:
            1.添加时入点不同,按入点的先后顺序排列;
            2.添加时入点相同,按添加动画贴纸的先后顺序排列。
        */
        public List<NvsTimelineAnimatedSticker> getAnimatedStickersByTimelinePosition(long timelinePos)

3.5.3 改变动画贴纸的属性

        //设置动画贴纸的缩放值
        public void setScale(float scale)
        //设置动画贴纸的水平翻转
        public void setHorizontalFlip(boolean flip)
        //设置动画贴纸的竖直翻转
        public void setVerticalFlip(boolean flip)
        //设置动画贴纸的旋转角度
        public void setRotationZ(float angle)
        //设置动画贴纸的平移
        public void setTranslation(PointF translation)

如果是全景图动画贴纸,则还可以设置下列属性:

        //对动画贴纸设置中心点的极角。
        public void setCenterPolarAngle(float centerPolarAngle)
        //对动画贴纸设置中心点的方位角。
        public void setCenterAzimuthAngle(float centerAzimuthAngle)
        //对动画贴纸设置极角的张角。
        public void setPolarAngleRange(float polarAngleRange)

3.5.4 改变动画贴纸的入出点

        //改变动画贴纸在时间线上显示的入点
        public long changeInPoint(long newInPoint)
        //改变动画贴纸在时间线上显示的出点
        public long changeOutPoint(long newOutPoint)
        //改变动画贴纸在时间线上的显示位置(入点和出点同时偏移offset值)
        public void movePosition(long offset)

3.6 主题

编辑视频时,如果需要运用主题,则可通过时间线(timeline)实现添加,移除以及获取。

3.6.1 添加与删除主题

        // 运用主题
        m_timeline.applyTheme(m_themeId.toString());

        //移除主题
        m_timeline.removeCurrentTheme();

3.6.2 获取timeline上的主题

        // 获取当前主题
        m_timeline.getCurrentThemeId();

3.6.3 改变主题的属性

        //设置主题片头的字幕文本
        public void setThemeTitleCaptionText(String text)
        //设置主题片尾的字幕文本
        public void setThemeTrailerCaptionText(String text)
        //设置主题音乐音量
        public void setThemeMusicVolumeGain(float leftVolumeGain, float rightVolumeGain)

3.7 转场

转场包括视频转场和音频转场。视频转场是在视频轨道上设置的,音频转场是在音频轨道上设置的。
视频转场:

        //视频转场包括内嵌式转场和包裹式转场,这里设置内嵌转场
        for(int i = 0;i<m_videoTrack.getClipCount();i++) {
            m_videoTrack.setBuiltinTransition(i,transitionName);
        }

        // 包裹式转场
        m_videoTrack.setPackagedTransition(m_transitionId.toString());

音频转场:

        //设置音频转场
        for(int i = 0;i<m_videoTrack.getClipCount();i++) {
            m_audioTrack.setBuiltinTransition(i,transitionName);
        }

3.8 特效

视频录制完成后,在后续制作中,经常会使用到几种特效,分别是视频特效(NvsVideoFx),音频特效(NvsAudioFx),时间线视频特效(NvsTimelineVideoFx)。

3.8.1 视频特效

视频特效是使用在视频片段上的,每个视频片段可以添加若干个视频特效。视频特效包括内嵌视频特效,包裹视频特效,美颜特效。
内嵌视频特效:

        //添加内嵌视频特效
        videoClip.appendBuiltinFx(fxName);

包裹视频特效:

        //追加包裹特效
        videoClip.appendPackagedFx(m_fxPackageId.toString());//添加包裹特效    

美颜特效:

        // 追加美颜特效
        videoClip.appendBeautyFx();

视频特效移除:

        //移除指定索引值的特效
        videoClip.removeFx(0);
        //清除所有特效
        videoClip.removeAllFx();

3.8.2 音频特效

音频特效是使用在音频片段上的,每个音频片段可以添加若干个音频特效。
音频特效添加:

        //添加音频特效
        audioClip.appendFx(fxName);

音频特效移除:

        //移除指定索引的音频特效
        audioClip.removeFx(0);

3.8.3 时间线视频特效

时间线视频特效,简单说,就是在时间线上使用的一种特效,包含内嵌特效和包裹特效。时间线上可以添加若干个时间线视频特效。

3.8.3.1 添加与删除时间线特效

时间线特效添加:

        //添加内建时间线特效
        for (int i = 0;i<m_videoTrack.getClipCount();i++) {
            NvsVideoClip videoClip = m_videoTrack.getClipByIndex(i);
            m_timeline.addBuiltinTimelineVideoFx(videoClip.getInPoint(),(videoClip.getOutPoint() - videoClip.getInPoint()),fxName);
        }

        //添加包裹时间线特效
        for (int i = 0;i<m_videoTrack.getClipCount();i++) {
            NvsVideoClip videoClip = m_videoTrack.getClipByIndex(i);
            m_timeline.addPackagedTimelineVideoFx(videoClip.getInPoint(),(videoClip.getOutPoint() - videoClip.getInPoint()),fxPackageId);
        }

3.8.3.2 获取时间线特效

        //获取时间线上第一个时间线视频特效
        public NvsTimelineVideoFx getFirstTimelineVideoFx()
        //获取时间线上最后一个时间线视频特效
        public NvsTimelineVideoFx getLastTimelineVideoFx()
        //获取时间线上某个时间线视频特效的前一个时间线视频特效
        public NvsTimelineVideoFx getPrevTimelineVideoFx(NvsTimelineVideoFx videoFx)
        //获取时间线上某个时间线视频特效的下一个时间线视频特效
        public NvsTimelineVideoFx getNextTimelineVideoFx(NvsTimelineVideoFx videoFx)
        /*
            根据时间线上的位置获得时间线视频特效,返回当前位置时间线视频特效对象的数组
            获取的时间线视频特效数组排序规则如下:
            1.添加时入点不同,按入点的先后顺序排列;
            2.添加时入点相同,按添加时间线视频特效的先后顺序排列。
        */
        public List<NvsTimelineVideoFx> getTimelineVideoFxByTimelinePosition(long timelinePos)

3.8.3.3 改变时间线特效的入出点

        //改变时间线视频特效在时间线上的入点
        public long changeInPoint(long newInPoint)
        //改变时间线视频特效在时间线上的出点
        public long changeOutPoint(long newOutPoint)
        //改变时间线视频特效在时间线上的位置(入点和出点同时偏移offset值)
        public void movePosition(long offset)

3.9 生成

美摄SDK使用compileTimeline()用于将时间线上的片段生成输出一个新的视频。

        //生成视频
        m_streamingContext.compileTimeline(m_timeline, 0, m_timeline.getDuration(),
            m_compilePath, NvsStreamingContext.COMPILE_VIDEO_RESOLUTION_GRADE_720, NvsStreamingContext.COMPILE_BITRATE_GRADE_HIGH, 0);

对应参数解释如下:

3.10 素材包管理

美摄SDK提供了丰富的素材库,包括动画贴纸,主题,字幕样式,转场等。素材包可以从网络上下载,或者由美摄SDK项目组提供,用户可以根据需要选择使用这些素材包。美摄SDK通过NvsAssetPackageManager类对这些素材包进行管理,可以安装,升级,卸载,获取素材包的状态,版本号等。
素材包安装:

        //此处采用同步安装方式,如果包裹过大可采用异步方式
        int error = m_streamingContext.getAssetPackageManager().installAssetPackage(stickerPackagePath, null, NvsAssetPackageManager.ASSET_PACKAGE_TYPE_ANIMATEDSTICKER, true, m_stickerId);

素材包安装:

        //此处采用同步升级方式,如果包裹过大可采用异步方式
        int error = m_streamingContext.getAssetPackageManager().upgradeAssetPackage(stickerPackagePath, null, NvsAssetPackageManager.ASSET_PACKAGE_TYPE_ANIMATEDSTICKER, true, m_stickerId);

素材包卸载:

        //素材包卸载
        int error = m_streamingContext.getAssetPackageManager().uninstallAssetPackage(m_stickerId,NvsAssetPackageManager.ASSET_PACKAGE_TYPE_ANIMATEDSTICKER);

3.11 回调

美摄SDK提供了很多回调接口,如果要查询采集设备状态,采集录制状态,视频播放状态,文件生成状态,资源包安装状态等,则必须在创建NvsStreamingContext对象后设置回调并实现对应的回调方法。
这里举例设置播放回调:

        //给Streaming context设置播放回调接口
        m_streamingContext.setPlaybackCallback(this);

4 附件

美摄SDK版本包括极速版,标准功能版,全功能PRO版,对于每个版本产品的功能点,请参考:https://www.meishesdk.com/editsdk,会有详细介绍。每个用户可根据个人需要选择使用,具体请联系美摄商务。