VIGOO积分对战游戏技术接入文档

一 使用说明

1. 版本号：1.0.0，更新时间：2020年08月08日
2. 提交游戏前，请务必阅读接入指引文档，完成自测，谢谢！https://www.jianshu.com/p/b7ca835b616a

二 接入流程

1. 请提供游戏地址给vigoo，地址需使用https

• 为方便调试，开发阶段可以先提供一个本地服务器地址，之后再提供海外服务器地址<VIGOO CDN>

2. vigoo返回游戏调试地址、Appkey

三 前端接口

1. 引入JS：https://sdk.vigoo.com/vigoo/sdk.js?v=版本号 示例：

<script src="https://sdk.vigoo.com/vigoo/sdk.js?v=1.0.0"></script>

2. vigooPVP.Init(Begin, End,Callback(data))

• 方法说明：
  　－传入游戏开始、游戏结束控制（必接），我方初始化完毕后，返回用户IP对应的语言代码，我方会在匹配完成后，开启游戏时和游戏时间结束时调用对应函数对游戏进行开始与结束的控制。
• 参数

属性	类型	说明
Begin	Function	开始游戏函数，调用后可开始立即开始游戏。
End	Function	结束游戏函数，调用后可立即结算游戏
Callback	Function	初始化完成后的回调函数

• 返回值：

属性	类型	说明
language	string	用户ip地区的语言代码，例如：zh 中文，en 英文等，cp根据对应语言代码，游戏内语言类型。

• 示例：

function begin(){
            ……
}
    function end(){
           ……
}
if( window["vigooPVP"] && window["vigooPVP"].Init ){
        window["vigooPVP"].Init(begin,end, (data)=>{
            console.log("language", data.language);
});
    }

3. vigooPVP.SetProgress(progress)

• 方法说明：
  　－上传游戏加载进度（必接），我方有加载页对正在加载中的游戏加载遮挡，需要游戏准确的加载进度，请将游戏加载的进度传入。
• 参数

属性	类型	说明
progress	Number	游戏加载进度百分比

• 示例：

if( window["vigooPVP"] && window["vigooPVP"].SetProgress ){
        window["vigooPVP"].SetProgress(progress);
}

4. vigooPVP.AddScore(score)

• 方法说明：
  　－上传玩家总分数（必接），上传玩家当前总的分数。分数将用于计算游戏房间内玩家的排名等。
  －分数字符串大的则为赢方
• 参数

属性	类型	说明
score	Number	玩家游戏过程中每次增长的分数

• 示例：

let numb = Math.floor(Math.random() * 100 + 1)
    score += numb;
 
    if( window["vigooPVP"] && window["vigooPVP"].AddScore ){
        window["vigooPVP"].AddScore(numb);
    }