> >

ShareREC 2.x.x 不向下兼容 1.x.x 版本,且必须使用ShareSDK 3.0.0以上,SMSSDK 3.0.0以上版本的相关SDK。获取的AppKey和AppSecret可以在相关不同SDK中兼容使用。

SystemRecorder用于录制整个设备屏幕的输出内容,不论当前应用是否前置

1、集成步骤

1、下载最新版本ShareREC for Android的SDK,解压以后复制ShareREC目录下的文件到您项目的根目录下覆盖。

2、修改“AndroidManifest.xml”文件,设置Application为MobApplication,也可设置成MobApplication的子类。在其中添加ShareREC的权限和AppKey 与AppSecret,添加需要用到的Activity:

<!-- 添加必要的权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

<application 
 android:name="com.mob.MobApplication"
 >
    <!-- 其它的activity -->

    <!-- ShareRec的activity -->
    <activity
        android:name="com.mob.tools.MobUIShell"
        android:configChanges="keyboardHidden|orientation|screenSize"
        android:theme="@android:style/Theme.Translucent.NoTitleBar"
        android:windowSoftInputMode="stateHidden|adjustResize" />

    <!-- 申请获得统一key Appkey和AppSecret --> 
    <meta-data android:name="Mob-AppKey" android:value="76684bc***"/>
    <meta-data android:name="Mob-AppSecret" android:value="cc162a0c24a4928e215a4b99ceff****"/>

</application>

如果不想修改application的name为MobApplication,请在调用ShareREC之前调用下面的代码:

MobSDK.init(context);

2、添加代码

1、设置要录制的View:

SystemRecorder recorder = new SystemRecorder();

2、添加一些初始化的配置,如:

// 设置视频的最大尺寸
recorder.setMaxFrameSize(LevelMaxFrameSize.LEVEL_1280_720);
// 设置视频的质量(高、中、低)
recorder.setVideoQuality(LevelVideoQuality.LEVEL_HIGH);
// 设置视频的最短时长
recorder.setMinDuration(10 * 1000);
// 设置视频的输出路径
recorder.setCacheFolder("/sdcard/ShareREC/cvr");

这些配置是可选的。

3、在启动视频录制前,需要先判断目标设备是否已被ShareRec支持:

recorder.isAvailable();

此方法将返回一个boolean结果,true则表示支持,否则为不支持。

4、启动和停止录制的方法分别为:

// 启动录制
recorder.start();

// 停止录制
recorder.stop();

3、其它配置

1、录制结束后,您可以调用下面的方法上传和分享您的视频:

recorder.showShare();

2、在分享前您还可以使用下面的方法为您的视频设置简短描述:

// 设置描述
recorder.setText("视频描述");

// 根据自定义字段添加描述
recorder.addCustomAttr("字段名称", "字段数值");

setText的优先级高于addCustomAttr,因此一旦两者都调用,后者将不起作用。

3、除了进入分享页面,您还可以在非录制期间进入个人资料页面和应用视频列表页面:

// 进入个人资料页面
recorder.showProfile();

// 进入应用视频列表页面
recorder.showVideoCenter();

4、注意事项

1、ShareRec的分享功能基于ShareSDK,如果您需要自定义分享功能,可以参考ShareSDK的相关文档进行定制

2、ShareRec的短信验证功能基于SMSSDK,如果您需要自定义此模块,可以参考SMSSDK的相关文档

3、SystemRecorder只能在Android 5.0(或Level 21)以上的系统运行

4、ShareRec需要联网