开发文档 > RecPlay SDK > RecPlay SDK Unity 3D > 集成文档
SDK下载
×
  • Unity 3D/Android

    • 概述

       

      • 录游SDK提供游戏视频录制与分享方案

        全引擎,Cocos2d-XUnity3DlibGdx、系统原生;

        多平台,iOSAndroid;

        无卡顿,边玩边录,视频同步生成无需等待压缩;

        上传快,CDN结合多线程实现视频快速上传;

        分享多,支持微博、微信、朋友圈等十余个平台分享;

        集成简,极少代码快速集成,无需root;

        配置精,提供同步解说录音开关,分辨率高清标清配置开关;

        适配广,引擎集成,几乎做到只要游戏在手机能运行就能录制游戏视频。

      • 录游 SDK Unity3D Android 平台

        支持Unity3D各版本(4.0,4.1需导出Android工程,用cocos2d-x方式接入点击跳转2dx接入文档

    • 接入方法

       这里介绍接入方法,有任何问题,请联系我们 sdk@youshixiu.com,谢谢!

      文件

      MD5

      RecPlay_unity3d_package_vx.x.x_xxx_xxxxxxxx.unitypackage

       

      • 导入sdk到Unity3D游戏

        1)       确认已安装unity3D环境 

        2)       双击RecPlay_unity3d_package_vx.x.x_xxx_xxxxxxxx.unitypackage

        3)     导入RecPlay_unity3d_package_vx.x.x_xxx_xxxxxxxx.unitypackage。选择import,导入完成后出现如下两个文件夹 

        4)       添加RecPlayPrefab到游戏中

        Ø  选择游戏的第一个场景(scene),可以在build&setting中查看自己的场景顺序




        Ø  选中Assets/RecPlay/Prefabs/RecPlayPrefab文件,并将RecPlayPrefab拖拽到“Hierarchy     空白区域,如下图



        Ø  拖拽完成后的结果如下图(不同游戏可能列表略有不同)



        5)       配置组件

        i. hierarchy选项卡中选择RecPlayPrefab,将在右侧Inspector选项卡中看到RecPlayPrefab对象的配置项。

        ii.如果出现"The associated script cannot be loaded."错误,需重新编译下所有脚本(在project选项卡,双击Assets/Plugins/RecPlay/ RecPlay.cs 脚本,打开MonoDevelop-Unity工具,重新编译脚本,如下图)
        iii. 编译完成后,切换到Unity3D工具,并设置相关参数,表现如下:

        • 在RecPlay Prefab游戏对象中设置 App ID和AppKey(Id和Key的申请,请联系sdk@youshixiu.com)如上图。
        • 选择是否显示SDK提供的UI ,即上图中的 “Show RecPlay UI”属性。
        • 设置保留自动录制视频数量,默认为6(此参数用来实现无UI自动录制控制视频的保留数量,如果勾选了Show UI,则无需改动)。


        6)       开始打包

        在菜单File>>Build Settings,打开build setting,如下图,并选中Android平台。

        注:点击“Player Settings ”按钮,在“Other Settings”选项中配置参数,如下:

                      1.设置“Minimum API Level”属性为4.0及以上。

                      2.设置“Graphics Level *”属性为 OpenGL ES 2.0”。

        7)     完成


      • 无UI版本说明

        其中SDK接入方式和2.1.1~2.1.5章节一致

        2.1.5章节的配置组件中选中无UI (即 Show LuYou UI选项不选中)如下图。

    • 无UI版的API说明

       

      • 接口

         注:自定义UI时,SetDeletageCallback接口必须调用,否则无法接收到事件。

        类名:RecPlay

        方法名

        描述

        参数

        返回值

        int IsSupported()

        是否支持录制

        1:支持录制。

        0:未知,

        -1:不支持

        -2:平台不支持

        -3:系统版本太低,仅支持4.0及以上。

        -4:没有sdcard

        -5:当前设备的cpu不是arm-v7a

        bool IsHDSupported()

        是否支持高清

        True支持,false 不支持

        bool  StartRecording()

        开始录制

        操作是否成功

        bool PauseRecording()

        暂停录制

        操作是否成功

        bool ResumeRecording()

        恢复录制

        操作是否成功

        bool StopRecording()

        停止录制

        操作是否成功

        bool IsRecording()

        当前是否正在录制

        True:当前正在录制,否则False

        bool IsPaused()

        当前是否在暂停状态。(确保在开始录制之后,未结束录制之前调用)

        True:当前录制是否暂停,否则False

        void SetDeletageCallback(boolean isDeletage)

        设置是否接收事件委托。在自定义UI时,该方法必须在添加委托事件之前调用。

        True/False

        True:当前接收事件委托,否则反之

        string GetLastRecordingFile()

        获取最后一个录制的文件

        返回最后一次录制的文件的绝对路径。

        string LoadThumbnailFromFilePath(string videoPath)

        获取指定路径的视频的缩略图

        Path:需要生成缩略图的视频文件的绝对路径

        返回缩略图保存的绝对路径。

        void SetMetadata(string key, string value)

        在录制过程中设置元数据,每次设置单条

        Key:指元数据的唯一标识,

        Value:指标识对应的值。

        void SetMetadatas (Dictionary<string,string> metadatas)

        在录制过程中设置元数据,每次设置多条

        Dictionary:多个键值对。

        void SetNotWifiAllowShare(bool isAllow)

        设置是否允许非wifi分享。

        isAllowtrue/false,允许或不允许

        string PublishVideo (string path,string title,string desc)

        发布视频

        Path:视频文件的路径

        Title:视频文件的标题

        Desc:视频文件的描述

        视频文件的唯一id

        void ResumePublishVideo (string videoid)

        继续发布视频

        Videoid 视频文件的唯一id

        void PausePublishVideo (string videoid)

        暂停发布视频

        Videoid 视频文件的唯一id,传入null暂停所有上传

         

        int GetVideoStatus(string videoid)

        获取当前视频的发布状态。

        videoId,视频的唯一id

         

        bool OAuthorLogin (string openId, string openType, string nick, string avatars)

        联合登陆

        openId联合登录唯一ID

        openType:联合登录类型(当前版本仅支持openTypecp)

        nick:联合登录昵称

        avatars:联合登录头像

        True:联合登录成功

        False:联合登录失败

        void SetChannel(string channelId, string channelKey)

        配置渠道信息

        (渠道信息详情参见附录5.1

         

        ChannelId:渠道id

        ChannelKey:渠道Key

        Void ShowUI(int type)

        展示UI界面(

        根据参数不同,展示不同的UI界面)

        type:界面类型

        (注:类型对应界面

        1.share界面

        2.本地视频界面

        3.云端视频界面(暂未实现)

        4.社区界面)

        long GetRecTime()

        获取录制时长

        返回当前录制时长

        void SetVideoQuality(string videoQuality)

        设置录制视频的清晰度

        videoQuality:视频清晰度(注:

        1.RecPlay.FD流畅

        2.RecPlay.SD标清

        3.RecPlay.HD高清

        4.RecPlay.UHD超清)

        void SetAudioEnable(Boolean isOn)

        设置音频开关(录制时是否录制音频)

        true:开启音频开关

        False:关闭音频开关

        void SetDefaultTitle(string title)

        设置默认视频标题

        title 视频标题

        void SetDefaultDesc(string desc)

        设置默认视频描述

        desc:视频描述

        void SetShareContent(string content)

        设置默认分享文案

        content:分享文案

      • 事件(委托)

        事件名

        委托(函数签名格式)

        描述

        RecordingStarted

        void RecordingStartedDelegate()

        该事件表示当前已经开始录制

        RecordingTime

        void RecordingTimeDelegate(int seconds)

        表示当前录制进行了多长的时间。每秒更新一次。

        RecordingWarning

        void RecordingWarningDelegate(int code,string msg)

        录制的警告。比如在设置的最小时长内停止录制,将触发该事件。

        RecordingFailed

        void RecordingFailedDelegate(int code,string msg)

        录制失败

        RecordingStoped

        void RecordingStopedDelegate()

        录制停止。

        SharerPreing

        void SharerPreingDelegate(string videoId)

        上传准备中的事件

        SharerPrepared

        void SharerPreparedDelegate(string videoId,string url)

        上传准备完成,其中url为分享链接。

        SharerStarted

        void SharerStartedDelegate(string videoId)

        上传开始事件

        SharerProgress

        void SharerProgressDelegate(string videoId,double progress)

        上传进度事件

        SharerComplete

        void SharerCompleteDelegate(string videoId)

        上传完成

        SharerFailed

        void SharerFailedDelegate(string videoId,int code,string msg)

        上传失败

    • 常见问题

       代码混淆保护

      -keep class com.KuPlay.rec.** { *;}
      -keep class org.acra.** { *;}
      -keep class com.qiniu.**{ *;}
      -keepattributes Signature

    • 附录

       渠道详情列表

      ChannelId

      ChannelKey

      Channel名称

      1

      淘宝手机助手

      2

      安智市场

      3

      91市场

      4

      华为智汇云

      5

      UC

      6

      四九游

      7

      安卓市场

      8

      小米市场

      9

      应用宝

      10

      豌豆荚

      11

      360手机助手

      12

      百度

      18

      游戏工场

      19

      联想

      20

      拇指玩

      21

      同步推

      22

      当乐游戏中心

      23

      四九游

  • Unity 3D/IOS

    • 概述

       

      • RecPlay提供游戏视频录制与分享方案

               全引擎,Cocos2d-XUnity3DlibGdx、系统原生;

        多平台,iOSAndroid;

        无卡顿,边玩边录,视频同步生成无需等待压缩;

        上传快,CDN结合多线程实现视频快速上传;

        分享多,支持微博、微信、朋友圈等十余个平台分享;

        集成简,极少代码快速集成,无需root;

        配置精,提供同步解说录音开关,分辨率高清标清配置开关;

        适配广,引擎集成,几乎做到只要游戏在手机能运行就能录制游戏视频。

      • RecPlay Unity3D iOS 平台

         支持Unity3D 4.5以上。


    • 接入方法

       这里介绍接入方法,有任何问题,请联系我们 sdk@youshixiu.com,谢谢!

      • 导入sdk到Unity3D游戏

        1)确认已安装unity3D环境

        2)双击RecPlay.unitypackage

        3)导入RecPlay.unitypackage。选择import,导入完成后出现如下两个文件夹

        4)添加RecPlayPrefab到游戏中

        Ø  选择游戏的第一个场景(scene),可以在build&setting中查看自己的场景顺序

        Ø  选中Assets/RecPlay/Prefabs/RecPlayPrefab文件,并将RecPlayPrefab拖拽到“Hierarchy     空白区域,如下图

        Ø  拖拽完成后的结果如下图(不同游戏可能列表略有不同)


      • 配置组件

        1)如果RecPlayPrefab中没有导入RecPlay Script,则将Assert/Plugins/RecPlay/RecPlay.cs文件拖入RecPlayPrefab中

        2)hierarchy选项卡中选择RecPlayPrefab,将在右侧Inspector选项卡中看到RecPlayPrefab对象的配置项。

        3)并设置相关参数,表现如下:

        Ø  RecPlay Prefab游戏对象中设置 App IDAppKeyIdKey的申请,请联系sdk@youshixiu.com)如上图。

        Ø  选择是否显示SDK提供的UI ,即上图中的 Show UI”属性。

        4)开始打包。

        5)在菜单File>>Build Settings,打开build setting,如下图,并选中iOS平台。

        注:点击“Player Settings ”按钮,在“Other Settings”选项中配置参数,如下:

        Ø  设置“Target iOS Version”属性为7.0及以上。

        Ø  设置“Graphics API”属性为 OpenGL ES 3.0”。

        6)编译unity工程,生成Xcode项目


      • 在Xcode中导入sdk

        参照“RecPlay_ios_2dx集成文档.docx”使用文档(点击跳转)

        注意:需要设置“Enable Objective-c Exceptions 属性为YES


      • 编译运行成功


         

      • 无UI版本说明

        其中SDK接入方式和2.1~2.4章节一致。
        2.2.2章节的配置组件中选中无UI (即 Show UI选项不选中)如下图。


    • 无UI版的API说明

       

      • 接口

         注:自定义UI时,SetDeletageCallback接口必须调用,否则无法接收到事件。

        类名:LuYou

        方法名

        描述

        参数

        返回值

        int IsSupported()

        是否支持录制

        1:支持录制。

        0:不支持

        bool IsHDSupported()

        是否支持高清

        True支持,false 不支持

        bool  StartRecording()

        开始录制

        操作是否成功

        bool PauseRecording()

        暂停录制

        操作是否成功

        bool ResumeRecording()

        恢复录制

        操作是否成功

        方法名

        描述

        参数

        返回值

        int IsSupported()

        是否支持录制

        1:支持录制。

        0:不支持

        bool IsHDSupported()

        是否支持高清

        True支持,false 不支持

        bool  StartRecording()

        开始录制

        操作是否成功

        bool PauseRecording()

        暂停录制

        操作是否成功

        bool ResumeRecording()

        恢复录制

        操作是否成功

        方法名

        描述

        参数

        返回值

        int IsSupported()

        是否支持录制

        1:支持录制。

        0:不支持

        bool IsHDSupported()

        是否支持高清

        True支持,false 不支持

        bool  StartRecording()

        开始录制

        操作是否成功

        bool PauseRecording()

        暂停录制

        操作是否成功

        string PublishVideo (string path,string title,string desc)

        发布视频

        Path:视频文件的路径

        Title:视频文件的标题

        Desc:视频文件的描述

         

         

        void ResumePublishVideo (string videoid)

        继续发布视频

        Videoid 视频文件的唯一id

        void PausePublishVideo (string videoid)

        暂停发布视频

        Videoid 视频文件的唯一id

         

        int GetVideoStatus(string videoid)

        获取当前视频的发布状态。

        videoId,视频的唯一id

         

        void oAuthorLogin(const char *openId,

                              const char *nick,

                              const char *headImageUrl);

        联合登录,通过openid来关联游视秀账号

        openid与游视秀账户绑定,

        nick 用户昵称

        headImageUrl 用户头像的URL

        void setKeepAutoRecVideoCount(int num);

        保留的视频数量

        自动录制视频时,保留的视频数量,默认为6

        调用toolBar录制的视频,或者玩家有编辑过的视频不计算在内

        num 保留视频数量

      • 事件(委托)

        事件名

        委托(函数签名格式)

        描述

        RecordingStarted

        void RecordingStartedDelegate()

        该事件表示当前已经开始录制

        RecordingTime

        void RecordingTimeDelegate(int seconds)

        表示当前录制进行了多长的时间。每秒更新一次。

        RecordingWarning

        void RecordingWarningDelegate(int code,string msg)

        录制的警告。比如在设置的最小时长内停止录制,将触发该事件。

        RecordingFailed

        void RecordingFailedDelegate(int code,string msg)

        录制失败

        RecordingStoped

        void RecordingStopedDelegate()

        录制停止。

        SharerPreing

        void SharerPreingDelegate(string videoId)

        上传准备中的事件

        SharerPrepared

        void SharerPreparedDelegate(string videoId,string url)

        上传准备完成,其中url为分享链接。

        SharerStarted

        void SharerStartedDelegate(string videoId)

        上传开始事件

        SharerProgress

        void SharerProgressDelegate(string videoId,double progress)

        上传进度事件

        SharerComplete

        void SharerCompleteDelegate(string videoId)

        上传完成

        SharerFailed

        void SharerFailedDelegate(string videoId,int code,string msg)

        上传失败

        RecPlayEnterUI

        void RecPlayEnterUIDelegate()

        进入RecPlayUI,此时建议将游戏暂停

        RecPlayTurnOutUI

        void RecPlayTurnOutUIDelegate()

        退出RecPlayUI,此时建议恢复游戏

选择下载游戏
目前暂不开放下载,您可以与我们联系获取,谢谢。
Q Q2250920646
QQ交流
×