增强SDK集成文档
SDK集成
注意：请先获取AppID（即licenseID），然后下载license文件和SDK进行集成。
运行环境要求
	Android API 14以上
	需要网络权限，用于鉴权
SDK引用
下载license文件，放到应用的assets目录下。
SDK包含如下几个jar包和so，根据你的项目结构，将它们分别放到对应的目录中。
例如，将jar包放到app/libs目录下，将so放到app/src/main/jniLibs目录下。
.
├── arm64-v8a
│   ├── libMARLIN.so
│   ├── libc++_shared.so
│   ├── liblicense.so
│   └── libmarlinJNI.so
├── armeabi-v7a
│   ├── libMARLIN.so
│   ├── libc++_shared.so
│   ├── liblicense.so
│   └── libmarlinJNI.so
├── license.jar
└── video_enhance.jar
在gradle中添加如下内容
implementation 'com.squareup.retrofit2:retrofit:2.1.0'
implementation 'com.squareup.retrofit2:converter-gson:2.1.0'
implementation 'com.squareup.retrofit2:adapter-rxjava:2.1.0'
implementation 'com.squareup.okhttp3:okhttp:3.10.0'


(一)证书创建
MyApplication extends Application

1:证书包名获取
String packageName = getPackageName();
Log.i(TAG, "getPackageName = " + packageName);
com.baidu.rtc.sample
2:证书创建

创建播放器证书
https://console.bce.baidu.com/bvc/?_=1632371401362#/bvc/player-license/list
https://console.bce.baidu.com/bvc/?_=1632371401362#/bvc/player-license/create
mAppID = licenseID 证书id
private String mAppID = "88439294938526310401p";
videoEnhanceFilter.setAppId(mAppID);


(二) 静态库加载
MyApplication extends Application
System.loadLibrary("c++_shared");
System.loadLibrary("MARLIN");
System.loadLibrary("marlinJNI");
System.loadLibrary("playerlicense");

(三)初始化


SDK使用
SDK为你提供了两种进行增强的方式：
在第一种方式中，以yuv数据作为SDK的数据输入，相应输出增强后的yuv数据；

在第二种方式中，使用方将图像绘制到SDK指定的SurfaceTexture上，同时指定SDK的目标surface，
则SDK会将增强后的图像数据绘制到指定的surface上。


下面分别介绍这两种方式下的SDK使用方法。
方式一：
在本方式中，使用VideoEnhanceUtils，接口描述如下
/**
 * 初始化
 * @param context Application Context
 * @param appID 申请的appid
 * @throws IllegalStateException 鉴权失败时，会抛出异常
 */
public void init(Context context, String appID) throws IllegalStateException

/**
 * 释放
 */
public void release()

/**
 * 以yuv数据作为输入进行增强，返回增强后的yuv数据
 * @param yuvData 输入yuv数据
 * @param stride yuv数据的stride width
 * @param sliceHeight yuv数据的slice height
 * @param format yuv格式{@link Format}，目前支持nv21和yuv420p
 * @param scale 设置视频增强指数，范围[0.0, 2.0]
 * @param alpha 设置视频增强清晰度指数，范围[0.0, 5.0]
 * @return 返回增强后的yuv数据
 */
public byte[] sendFrame(byte[] yuvData, int stride, int sliceHeight, Format format, float scale, float alpha)

使用示例
private String mAppID = "80871368140545843201p";
private VideoEnhanceUtils mVeUtils;
mVeUtils = new VideoEnhanceUtils();
mVeUtils.init(mContext, mAppID);


protected int mOutputWidth;
protected int mOutputHeight;
byte[] yuvInput = new byte[mOutputWidth * mOutputHeight * 3 / 2];
//将你的yuv数据填充到yuvInput中
...
private float mScale = 1.2f;
private float mAlpha = 3.0f;
byte[] yuvOutput = mVeUtils.sendFrame(yuvInput, mOutputWidth, mOutputHeight,
        VideoEnhanceUtils.Format.NV21, mScale, mAlpha);
...
mVeUtils.release();

方式二：
在本方式中，使用VideoEnhanceFilter，接口描述如下
/**
 * 设置Appid
 * @param appId 申请的appid
 */
public static void setAppId(String appId)

/**
 * 初始化
 * @param context ApplicationContext
 */
public void setup(Context context)

/**
 * 释放
 */
public void release()

/**
 * 开始/继续绘制
 */
public void resume()

/**
 * 暂停绘制
 */
public void pause()

/**
 * 设置输入视频帧的宽高
 *
 * @param width 视频宽
 * @param height 视频高
 */
public void setInputVideoSize(int width, int height)

/**
 * 返回一个SurfaceTexture
 * 通过这个SurfaceTexture把视频帧送给增强SDK
 */
public SurfaceTexture getInputSurfaceTexture()

/**
 * 指定最终要在哪个surface上展示增强输出效果
 */
public void setTargetSurface(Surface surface)

/**
 * 指定目标surface的宽和高
 */
public void setTargetSurfaceSize(int width, int height)

/**
 * 设置视频增强指数，范围[0.0, 2.0]
 */
public void setScale(float scale)

/**
 * 设置视频增强清晰度指数，范围[0.0, 5.0]
 */
public void setAlpha(float alpha)

/**
 * 是否开启增强
 */
public void setDoEnhance(boolean doEnhance)

/**
 * 设置预览模式{@link PreviewMode}
 * {@link PreviewMode#SINGLE_SCREEN} 只绘制增强后的图像
 * {@link PreviewMode#MULTI_SCREEN} 分屏绘制增强后的图像和原始图像
 */
public void setPreviewMode(PreviewMode previewMode)

使用示例
在本示例中，以结合android MediaPlayer使用为例
private VideoEnhanceFilter videoEnhanceFilter;
private MediaPlayer mMediaPlayer;
//初始化
mMediaPlayer = new MediaPlayer();
mMediaPlayer.setDataSource("/sdcard/test.mp4");


private String mAppID = "80871368140545843201p";
VideoEnhanceFilter.setAppId(mAppID);
videoEnhanceFilter = new VideoEnhanceFilter();
videoEnhanceFilter.setUp(mContext);


//设置surface
private SurfaceHolder holder;
mMediaPlayer.setSurface(new Surface(videoEnhanceFilter.getInputSurfaceTexture()));

videoEnhanceFilter.setTargetSurface(holder.getSurface());

videoEnhanceFilter.setDoEnhance(true);
videoEnhanceFilter.setScale(1.2f);
videoEnhanceFilter.setAlpha(3.0f);
videoEnhanceFilter.setPreviewMode(VideoEnhanceFilter.PreviewMode.SINGLE_SCREEN);

//设置视频源宽高（此时无需考虑stride）,可以在mediaplayer的OnVideoSizeChangedListener回调中使用
videoEnhanceFilter.setInputVideoSize(mVideoWidth, mVideoHeight);
//设置surface宽高，可以在onSurfaceChanged回调中使用
videoEnhanceFilter.setTargetSurfaceSize(mSurfaceWidth, mSurfaceHeight);


//开始绘制
mMediaPlayer.start();
videoEnhanceFilter.resume();


//暂停
mMediaPlayer.pause();
videoEnhanceFilter.pause();


//释放
mMediaPlayer.release();
videoEnhanceFilter.release();

