wawa

setLogEnable isRegisterAppSuccess setUserInfo logout

用户账号管理

requestCommonUserInfoWithUid requestUserWardrobeAtPage requestCreateOrderWithWawaIds

用户地址管理

requestAddAddress requestSetDefaultAddress

物流查询

requestExpressInfo

娃娃、积分、金币

requestExchangeWawaWithType requestMallExchangeWithWWID

申诉、举报

requestComplainGame requestReportUser

游戏房间管理

requestRoomListByIds cancelRequestRoomTimer requestViewerWithRoomId cancelRequestViewerTimer requestCatchHistory requestServerTime

游戏管理

showRoom closeRoom startGamePlayer requestStartGame requestClawWithForceRelease requestQuickOnBoard

监听

addEventListener

概述

阿凡达娃娃机简介

阿凡达在线抓娃娃

模块概述

wawa 模块封装了阿凡达娃娃机的开放 SDK

模块使用攻略

1.注册阿凡达云账号 2.配置config文件

配置方法如下：

  • 名称：wawa
  • 参数：appId、appKey
  • 配置示例:

  • 字段描述:

    appId：在阿凡达娃娃机开放平台申请的 AppId

    appKey：在阿凡达娃娃机开放平台申请的 AppKey

模块接口

setLogEnable

开启、关闭log

setLogEnable(callback(ret))

params

logEnable：

  • 类型：布尔
  • 描述：（可选项）是否开启log
  • 默认：true

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.setLogEnable({
  3.    logEnable:true
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getVersion

获取版本号

getVersion(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     version: ‘’      //字符串类型；版本号
  3. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.getVersion(function(ret) {
  3.     alert(ret.version);
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

isRegisterAppSuccess

判断阿凡达娃娃机 SDK 是否初始化成功

isRegisterAppSuccess(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.isRegisterAppSuccess(function(ret) {
  3.     if (ret.status) {
  4.         alert('已初始化');
  5.     } else {
  6.         alert('初始化失败');
  7.     }
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

registerApp

初始化阿凡达娃娃机 SDK， 向 SDK 注册 appid appkey

注意：App 启动时，模块会自动读取 config.xml 文件内的 appid 和 appkey 参数完成初始化注册。若App 启动时初始化失败，可调用本接口再次初始化。

registerApp(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.registerApp(function(ret) {
  3.     if (ret.status) {
  4.         alert('已初始化');
  5.     } else {
  6.         alert('初始化失败');
  7.     }
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setUserInfo

设置用户信息

setUserInfo({params})

params

uid：

  • 类型：字符串
  • 描述：uid

name：

  • 类型：字符串
  • 描述：用户名

avatar：

  • 类型：字符串
  • 描述：头像地址

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.setUserInfo({
  3.    uid:'110',
  4.    name:'嘿嘿嘿',
  5.    avatar:'https://ss1.bdstatic.com/70cFuXSh_Q1YnxGkpoWK1HF6hhy/it/u=444225515,3056104404&fm=27&gp=0.jpg'
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

login

合作方，当用户从匿名，登陆之后，主动触发调用。

login(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：登录信息
  • 内部字段：
  1. {
  2.       code: ,        //数字类型；状态码
  3.       message: ''    //字符串类型；登录信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.login(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

logout

合作方，退出登录。

logout()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.logout();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestUserInfo

请求当前登陆用户信息

requestUserInfo(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：登录信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；登录信息
  4.       userModel: {        //JOSN对象；玩儿家信息描述
  5.          uid:,            //数字类型；用户ID
  6.          gender:,         //数字类型；性别, 1男 0女
  7.          portrait:,       //字符串类型；头像
  8.          nickname:,       //字符串类型；昵称
  9.          spoils:          //数字类型；战利品个数
  10.       }
  11. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestUserInfo(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestCommonUserInfoWithUid

请求用户信息

requestCommonUserInfoWithUid({params},callback(ret))

params

uid：

  • 类型：数字
  • 描述：（可选项）要请求的用户uid。注意，这个uid不是接入方服务器分配的uid, 而是通过SDK接口获取的uid. 当看自己，传0
  • 默认：0

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       userModel: {        //JOSN对象；玩儿家信息描述
  5.          uid:,            //数字类型；用户ID
  6.          gender:,         //数字类型；性别, 1男 0女
  7.          portrait:,       //字符串类型；头像
  8.          nickname:,       //字符串类型；昵称
  9.          spoils:          //数字类型；战利品个数
  10.       }
  11. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestCommonUserInfoWithUid({
  3.    uid:1
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestGameHistoryAtPage

请求用户游戏记录

requestGameHistoryAtPage({params},callback(ret))

params

page：

  • 类型：数字
  • 描述：页数，从1开始
  • 默认：1

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       gameRecordModels:[{ //数组类型；游戏记录描述
  5.          dateline:,       //字符串类型；游戏时间
  6.          orderId:,        //字符串类型；记录Id
  7.          wawaId:,            //数字类型；娃娃ID
  8.          status:,         //数字类型；状态 0:失败（游戏失败，如机器故障）; 1:未抓中; 2:抓中;
  9.          coin:,           //数字类型；消耗金币
  10.          awardFishball:,  //数字类型;消耗鱼丸
  11.          awardFishbal:,   //字符串类型； 奖励鱼丸
  12.          video:{          //JONS对象；视频回放描述对象
  13.             machineStream:,//字符串类型；
  14.             livekey:,     //字符串类型；
  15.             startTime:,   //数字类型；时间戳，单位为秒，从1970-1-1 00:00:00开始
  16.             duration:     //数字类型；单位为秒
  17.          },
  18.          wawa:{           //JONS对象；个人游戏记录
  19.             ID:,          //数字类型；
  20.             flag:,        //数字类型；
  21.             coin:,        //数字类型；
  22.             pic:,         //字符串类型；娃娃缩略图
  23.             icon:,        //字符串类型；
  24.             name:         //字符串类型；娃娃名称
  25.          }
  26.       }]
  27. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestGameHistoryAtPage({
  3.    page:1
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestUserWardrobeAtPage

请求用户战利品列表

requestUserWardrobeAtPage({params},callback(ret))

params

page：

  • 类型：数字
  • 描述：页数，从1开始
  • 默认：1

userId：

  • 类型：数字
  • 描述：看谁的战利品，传谁的uid. 当登陆用户查看自己。 uid传0
  • 默认：0

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,               //数字类型；状态码
  3.       message: ''           //字符串类型；信息
  4.       wardrobeModel:{       //JSON对象；战利品信息
  5.           warTrophyHead:{    //JSON对象；用户战利品数目
  6.              level1:,        //数字类型；等级1的战利品数目
  7.              level2:,        //数字类型；等级2的战利品数目
  8.              level3:,        //数字类型；等级3的战利品数目
  9.              level4:,        //数字类型；等级4的战利品数目
  10.              spoils:,        //数字类型；战利品总数
  11.           },
  12.           warTrophyInfo:[{   //JSON对象；战利品信息
  13.              dateline:,      //字符串类型；
  14.              uid:,           //数字类型；
  15.              wawaId:,        //数字类型；
  16.              total:,         //数字类型；
  17.              wawa:{          //JSON对象；
  18.                 ID:,          //数字类型；
  19.                 flag:,        //数字类型；
  20.                 coin:,        //数字类型；
  21.                 pic:,         //字符串类型；娃娃缩略图
  22.                 icon:,        //字符串类型；
  23.                 name:         //字符串类型；娃娃名称
  24.              }
  25.           }]
  26.       }
  27. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestUserWardrobeAtPage({
  3.    page:1,
  4.    userId: 0
  5. },function(ret){
  6.    api.alert({msg:JSON.stringify(ret)});
  7. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestUserWawa

请求用户抓取到的娃娃列表

requestUserWawa({params},callback(ret))

params

type：

  • 类型：字符串
  • 描述：娃娃类型
  • 默认：all

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,                   //数字类型；状态码
  3.       message: ''               //字符串类型；信息
  4.       userWawaModel:{           //JSON对象；用户抓到娃娃与发货订单数据
  5.          expressTotalCount:,    //数字类型；已经发货总数
  6.          exchangeTotalCount:,   //数字类型；已兑换总数
  7.          depositTotalCount:,    //数字类型；寄存中总数
  8.          expressList:[{   //数组类型；已发货的
  9.             orderId: ,    //字符串类型；订单 id
  10.             status: ,     //数字类型；快递状态，0发货准备中；1运送中；2已收货 
  11.             dateline:,    //字符串类型；申请发货时间
  12.             selected: ,   //布尔类型；标记选中
  13.             records:[{    //数组类型；娃娃发货订单条目
  14.               wid: ,      //数字类型；娃娃id
  15.               pic: ,      //字符串类型；娃娃详图
  16.               name: ,     //字符串类型；娃娃名称
  17.               coin: ,     //数字类型；价值
  18.               num: ,      //数字类型；娃娃数量
  19.               selected:   //布尔类型；标记选中
  20.             }]
  21.          }],      
  22.          exchangeList:[{}],//数组类型；已兑换列表内部字段同expressList
  23.          depositList:[{   //数组类型；寄存中
  24.               ID: ,       //数字类型；记录ID
  25.               wid: ,      //数字类型；娃娃id
  26.               expTime:,   //数字类型；寄存剩余天数
  27.               pic: ,      //字符串类型；娃娃详图
  28.               icon: ,     //字符串类型；娃娃单体icon
  29.               portrait: , //字符串类型；娃娃缩头像
  30.               name: ,     //字符串类型；娃娃名称
  31.               coin: ,     //数字类型；价值
  32.               selected:   //布尔类型；标记选中
  33.          }]     
  34.       }
  35. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestUserWawa(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestCreateOrderWithWawaIds

请求发货

requestCreateOrderWithWawaIds({params},callback(ret))

params

wawaIds：

  • 类型：数组
  • 描述：娃娃寄存项ID数组

addressModel：

  • 类型：JSON对象
  • 描述：地址信息
  • 内部字段：
  1. {
  2.          ID:,             //数字类型；地址ID
  3.          province:,       //字符串类型；省份
  4.          city:,           //字符串类型；城市
  5.          district:,       //字符串类型；县,区
  6.          address:,        //字符串类型；详细地址
  7.          name:,           //字符串类型;联系人
  8.          phone:,          //字符串类型;手机
  9.          isDefault:       //布尔类型； 是否默认地址
  10. }

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestCreateOrderWithWawaIds({
  3.    wawaIds:[]
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestMyAddressList

请求用户地址列表

requestMyAddressList(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：地址信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       addressModels:[{    //数组类型；玩家地址信息描述
  5.          ID:,             //数字类型；地址ID
  6.          province:,       //字符串类型；省份
  7.          city:,           //字符串类型；城市
  8.          district:,       //字符串类型；县,区
  9.          address:,        //字符串类型；详细地址
  10.          name:,           //字符串类型;联系人
  11.          phone:,          //字符串类型;手机
  12.          isDefault:       //布尔类型； 是否默认地址
  13.       }]
  14. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestMyAddressList(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestAddAddress

新加入一个收货地址

requestAddAddress({params},callback(ret))

params

addressModel：

  • 类型：JSON对象
  • 描述：地址信息
  • 内部字段：
  1. {
  2.          ID:,             //数字类型；地址ID
  3.          province:,       //字符串类型；省份
  4.          city:,           //字符串类型；城市
  5.          district:,       //字符串类型；县,区
  6.          address:,        //字符串类型；详细地址
  7.          name:,           //字符串类型;联系人
  8.          phone:,          //字符串类型;手机
  9.          isDefault:       //布尔类型； 是否默认地址
  10. }

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：修改结果
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestAddAddress({
  3.    addressModel:''
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestUpdateAddress

编辑修改一个收货地址。

此时ID，必须填写。使用正在编辑地址ID

requestUpdateAddress({params},callback(ret))

params

addressModel：

  • 类型：JSON对象
  • 描述：地址信息
  • 内部字段：
  1. {
  2.          ID:,             //数字类型；地址ID
  3.          province:,       //字符串类型；省份
  4.          city:,           //字符串类型；城市
  5.          district:,       //字符串类型；县,区
  6.          address:,        //字符串类型；详细地址
  7.          name:,           //字符串类型;联系人
  8.          phone:,          //字符串类型;手机
  9.          isDefault:       //布尔类型； 是否默认地址
  10. }

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：修改结果
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4. }

示例代码

iOS系统，Android系统

可提供的1.0.0及更高版本

requestSetDefaultAddress

设置已有一个地址为默认地址

requestSetDefaultAddress({params},callback(ret))

params

aId：

  • 类型：数字
  • 描述：地址ID

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：修改结果
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestSetDefaultAddress({
  3.    aId:''
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

requestDeleteAddress

删除一个收货地址

requestDeleteAddress({params},callback(ret))

params

aID：

  • 类型：字符串
  • 描述：地址 id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：修改结果
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestDeleteAddress({
  3.    aID:''
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestExpressInfo

物流查询

requestExpressInfo({params},callback(ret))

params

orderId：

  • 类型：字符串
  • 描述：订单id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：返回信息
  • 内部字段：
  1. {
  2.       code: ,               //数字类型；状态码
  3.       message: ''           //字符串类型；信息
  4.       expressInfo:{         //JSON对象；
  5.          number:,           //字符串类型；
  6.          type:,             //字符串类型；
  7.          company:,          //字符串类型；
  8.          deliverystatus:,   //数字类型；1.在途中 2. 派送中 3. 已签收 4. 派送失败或者拒收
  9.          issign:,           //数字类型；
  10.          wawaNum:,          //数字类型；
  11.          tel:,              //字符串类型；
  12.          list:[{            //JSON对象；
  13.             status:,        //字符串类型；
  14.             time:,          //字符串类型；
  15.             isFirst:,       //布尔类型；
  16.             isLast:         //布尔类型；
  17.          }],
  18.          wawa:{             //JSON对象；
  19.                 ID:,          //数字类型；
  20.                 flag:,        //数字类型；
  21.                 coin:,        //数字类型；
  22.                 pic:,         //字符串类型；娃娃缩略图
  23.                 icon:,        //字符串类型；
  24.                 name:         //字符串类型；娃娃名称
  25.          }
  26.       }
  27. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestExpressInfo({
  3.     orderId:
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestConfirmReceived

确认收货

requestConfirmReceived({params},callback(ret))

params

orderId：

  • 类型：字符串
  • 描述：订单id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：返回信息
  • 内部字段：
  1. {
  2.       code: ,               //数字类型；状态码
  3.       message: ''           //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestConfirmReceived({
  3.     orderId:
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestExchangeWawaWithType

将娃娃兑换为金币

requestExchangeWawaWithType({params},callback(ret))

params

type：

  • 类型：字符串
  • 描述：（可选项）娃娃类型
  • 默认：all
  • 取值范围：
    • deposit：寄存中
    • deliver：运送中
    • exchange：已兑换
    • all：全部

wawaIds：

  • 类型：数组
  • 描述：娃娃id数组

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,                   //数字类型；状态码
  3.       message: ''               //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestExchangeWawaWithType(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestMallListAtPage

请求积分商城列表

requestMallListAtPage({params},callback(ret))

params

page：

  • 类型：数字
  • 描述：页码，从1开始

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,              //数字类型；状态码
  3.       success: ''          //布尔类型；是否成功
  4.       mallList: [{         //数组对象；
  5.          code:,            //字符串类型；
  6.          exchangeFishball:,//数字类型；
  7.          flag:,            //数字类型；
  8.          ID:,              //数字类型；
  9.          name:'',          //字符串类型；
  10.          pic:''            //字符串类型；
  11.       }]
  12. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestMallListAtPage({
  3.    wawaIds:[]
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestMallExchangeWithWWID

积分兑换娃娃

requestMallExchangeWithWWID({params},callback(ret))

params

wid：

  • 类型：数字
  • 描述：兑换娃娃的 id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：商品信息
  • 内部字段：
  1. {
  2.       code: ,               //数字类型；状态码
  3.       message: ''           //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestMallExchangeWithWWID({
  3.    wid:1
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestComplainReasonList

获取申诉的原因列表

requestComplainReasonList(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,                 //数字类型；状态码
  3.       message: ''             //字符串类型；信息
  4.       complainReasonList: [{  //数组类型；
  5.           ID:,                //数字类型；
  6.           reason:''           //字符串类型；
  7.       }]          
  8. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestComplainReasonList(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestComplainGame

请求申述游戏

requestComplainGame({params},callback(ret))

params

orderID：

  • 类型：字符串
  • 描述：订单 id

reason：

  • 类型：字符串
  • 描述：理由

reasonId：

  • 类型：字符串
  • 描述：理由 id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestComplainGame({
  3.     orderID:
  4.     reason:
  5.     reasonId:
  6. },function(ret){
  7.    api.alert({msg:JSON.stringify(ret)});
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestComplainResultWithOrderID

游戏申述状态

requestComplainResultWithOrderID({params},callback(ret))

params

orderID：

  • 类型：字符串
  • 描述：订单 id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,                 //数字类型；状态码
  3.       message: ''             //字符串类型；信息
  4.       isComplain:             //布尔类型；        
  5. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestComplainResultWithOrderID(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestReportUser

房间内举报某个用户

requestReportUser({params},callback(ret))

params

uid：

  • 类型：字符串
  • 描述：用户id

type：

  • 类型：字符串
  • 描述：类型
  • 默认：other
  • 取值范围：
    • other：其它内容
    • porno：色情低俗
    • political：政治敏感
    • ad：广告欺诈
    • abuse：骚扰谩骂

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：游戏记录信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestReportUser({
  3.     uid:
  4.     type:
  5.     rid:
  6. },function(ret){
  7.    api.alert({msg:JSON.stringify(ret)});
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestRoomListAtPage

请求房间列表

requestRoomListAtPage({params},callback(ret))

params

page：

  • 类型：数字
  • 描述：请求列表页，从1开始
  • 默认：1

size：

  • 类型：数字
  • 描述：每页个数
  • 默认：10

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       roomModels:[{       //数组类型； 游戏房间描述对象
  5.          ID:,             //数字类型；房间ID
  6.          state: ,         //数字类型；房间状态: 小于1:故障 1：补货 2:空闲 大于2:游戏中
  7.          uid: ,           //数字类型； 在玩的人uid
  8.          streamMaster:,   //字符串类型；
  9.          streamSlave:,    //字符串类型；
  10.          wawa:{           //JSON对象；玩具描述
  11.             ID: ,         //数字类型；娃娃ID
  12.             flag: ,       //数字类型；按位与运算，0位标识是否新品娃娃，1位标识是否热门
  13.             coin:,        //数字类型；所需金币
  14.             fishball: ,   //数字类型；所需鱼丸
  15.             name:,        //字符串类型；娃娃名称
  16.             icon:,        //字符串类型；娃娃价值
  17.             pic:          //字符串类型；娃娃缩略图
  18.          },      
  19.          userModel: {     //JOSN对象；玩儿家信息描述
  20.              uid:,         //数字类型；用户ID
  21.              gender:,      //数字类型；性别, 1男 0女
  22.              portrait:,    //字符串类型；头像
  23.              nickname:,    //字符串类型；昵称
  24.              spoils:,      //字符串类型；生日 yyyy-MM-dd
  25.           }   
  26.       }]
  27. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestRoomListAtPage(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestRoomListByIds

请求指定房间信息

requestRoomListByIds({params},callback(ret))

params

roomIds：

  • 类型：数组
  • 描述：房间列表的id组成的数组

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       roomModels:[{       //数组类型； 游戏房间描述对象
  5.          ID:,             //数字类型；房间ID
  6.          state: ,         //数字类型；房间状态: 小于1:故障 1：补货 2:空闲 大于2:游戏中
  7.          uid: ,           //数字类型； 在玩的人uid
  8.          streamMaster:,   //字符串类型；
  9.          streamSlave:,    //字符串类型；
  10.          wawa:{           //JSON对象；玩具描述
  11.             ID: ,         //数字类型；娃娃ID
  12.             flag: ,       //数字类型；按位与运算，0位标识是否新品娃娃，1位标识是否热门
  13.             coin:,        //数字类型；所需金币
  14.             fishball: ,   //数字类型；所需鱼丸
  15.             name:,        //字符串类型；娃娃名称
  16.             icon:,        //字符串类型；娃娃价值
  17.             pic:          //字符串类型；娃娃缩略图
  18.          },      
  19.          userModel: {     //JOSN对象；玩儿家信息描述
  20.              uid:,         //数字类型；用户ID
  21.              gender:,      //数字类型；性别, 1男 0女
  22.              portrait:,    //字符串类型；头像
  23.              nickname:,    //字符串类型；昵称
  24.              spoils:,      //字符串类型；生日 yyyy-MM-dd
  25.           }   
  26.       }]
  27. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestRoomListByIds(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

startRequestRoomTimer

启动首页数据刷新定时器

该方法首先会销毁当前刷新定时器，并根据当前period重新创建新的刷新定时器

startRequestRoomTimer({params},callback(ret))

params

interval：

  • 类型：数字
  • 描述：（可选项）定时器触发间隔，单位S, 最小10s
  • 默认：15

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.startRequestRoomTimer({
  3.   interval:20
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

cancelRequestRoomTimer

停止首页数据刷新定时器

该方法会立即停止当前激活的刷新定时器

cancelRequestRoomTimer()

示例代码

  1. var wawa = api.require('wawa');

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestRoomInfo

获取房间信息与状态接口

requestRoomInfo({params},callback(ret))

params

roomId：

  • 类型：数字
  • 描述：房间列表的id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       roomModel:{         //JSON对象类型； 游戏房间描述对象
  5.          ID:,             //数字类型；房间ID
  6.          state: ,         //数字类型；房间状态: 小于1:故障 1：补货 2:空闲 大于2:游戏中
  7.          uid: ,           //数字类型； 在玩的人uid
  8.          streamMaster:,   //字符串类型；
  9.          streamSlave:,    //字符串类型；
  10.          wawa:{           //JSON对象；玩具描述
  11.             ID: ,         //数字类型；娃娃ID
  12.             flag: ,       //数字类型；按位与运算，0位标识是否新品娃娃，1位标识是否热门
  13.             coin:,        //数字类型；所需金币
  14.             fishball: ,   //数字类型；所需鱼丸
  15.             name:,        //字符串类型；娃娃名称
  16.             icon:,        //字符串类型；娃娃价值
  17.             pic:          //字符串类型；娃娃缩略图
  18.          },      
  19.          userModel: {     //JOSN对象；玩儿家信息描述
  20.              uid:,         //数字类型；用户ID
  21.              gender:,      //数字类型；性别, 1男 0女
  22.              portrait:,    //字符串类型；头像
  23.              nickname:,    //字符串类型；昵称
  24.              spoils:,      //字符串类型；生日 yyyy-MM-dd
  25.           }   
  26.       }
  27. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestRoomInfo({
  3.    roomId:123
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestViewerWithRoomId

观众列表获取

requestViewerWithRoomId({params},callback(ret))

params

roomId：

  • 类型：数字
  • 描述：房间列表的id

page：

  • 类型：数字
  • 描述：页码

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       userModels: [{      //数组类型；玩儿家信息描述
  5.              uid:,         //数字类型；用户ID
  6.              gender:,      //数字类型；性别, 1男 0女
  7.              portrait:,    //字符串类型；头像
  8.              nickname:,    //字符串类型；昵称
  9.              spoils:,      //字符串类型；生日 yyyy-MM-dd
  10.        }] 
  11. }

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

startRequestViewerTimer

开启定时刷新观众列表定时器，房间默认为当前进入的房间

startRequestViewerTimer({params},callback(ret))

params

interval：

  • 类型：数字
  • 描述：（可选项）定时器触发间隔，单位S, 最小10s
  • 默认：15

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.startRequestViewerTimer({
  3.   interval:20
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

cancelRequestViewerTimer

取消刷新观众列表定时器

cancelRequestViewerTimer()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.cancelRequestViewerTimer();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestWawaDetail

娃娃详情查询

requestWawaDetail({params},callback(ret))

params

wid：

  • 类型：数字
  • 描述：娃娃的id

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；信息
  4.       wawaDetail:{        //JSON对象； 娃娃信息
  5.          ID:,             //数字类型；娃娃 id
  7.          size: ,          //数字类型； 
  8.          coin:,           //数字类型；单次抓娃娃消耗金币
  9.          recoverCoin:,    //数字类型；可兑换金币数量
  10.          brand:,          //字符串类型；品牌
  11.          suitAge:,        //字符串类型；适用年龄
  12.          detailPics:,     //字符串类型；娃娃详情图片，按逗号分开
  13.          filler:,         //字符串类型；填充物
  14.          material:,       //字符串类型；面料
  15.          icon:,           //字符串类型；陈列柜图片
  16.          pic:,            //字符串类型；封面图
  17.          level:           //数字类型；等级
  18.       }
  19. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestWawaDetail({
  3.    roomId:123,
  4.    page:1
  5. },function(ret){
  6.    api.alert({msg:JSON.stringify(ret)});
  7. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestCatchHistory

查询房间最近抓中记录

params

roomId：

  • 类型：数字
  • 描述：房间 id

page：

  • 类型：数字
  • 描述：（可选项）请求第几页数据
  • 默认：1

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；获取信息
  4.       roomCatchRecords:[{ //数组对象；房间内最近抓中游戏记录
  5.          dateline:,       //字符串类型；
  6.          orderId: ,       //字符串类型；
  7.          wawaId: ,        //数字类型； 
  8.          video: {         //JSON对象；视频回放描述
  9.             machineStream:,//字符串类型；
  10.             livekey:,     //字符串类型；
  11.             startTime:,   //数字类型；单位为秒，从1970-1-1 00:00:00开始
  12.             duration:     //数字类型；单位为秒
  13.          },      
  14.          userModel: {     //JOSN对象；抓中娃娃的人
  15.              uid:,         //数字类型；用户ID
  16.              gender:,      //数字类型；性别, 1男 0女
  17.              portrait:,    //字符串类型；头像
  18.              nickname:,    //字符串类型；昵称
  19.              spoils:,      //数字类型；战利品个数
  20.           } 
  21.       }]
  22. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestCatchHistory({
  3.     roomId: ,
  4.     page:
  5. },function(ret){
  6.    api.alert({msg:JSON.stringify(ret)});
  7. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestReplayVideoMessage

请求回放中 游戏操作信息

requestReplayVideoMessage({params},callback(ret))

params

roomId：

  • 类型：数字
  • 描述：房间 id

startTimeSecond:

  • 类型：数字类型
  • 描述：游戏开始时间，单位S，秒

piece：

  • 类型：数字
  • 描述：第几片数据 从1开始，1片30s

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //字符串类型；获取信息
  4.       infoList:[{}]       //数组对象；信息数组，内部元素是JSON对象
  5. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestReplayVideoMessage({
  3.     roomId: ,
  4.     startTimeSecond:,
  5.     piece:
  6. },function(ret){
  7.    api.alert({msg:JSON.stringify(ret)});
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestServerTime

获取当前的服务器时间

说明: 此接口用于分享游戏的时候获取服务器时间戳, 用于前端获取分享时间点, 进而获取分享时间点前后的游戏视频流

requestServerTime(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       interval:           //数字类型；状态码  
  3. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestServerTime(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

enterRoom

加入房间

enterRoom({params},callback(ret))

params

roomModel：

  • 类型：JSON对象
  • 描述：房间描述
  • 内部字段：
  1. {      
  2.      ID:,             //数字类型；房间ID
  3.      streamMaster:,   //字符串类型；
  4.      streamSlave:     //字符串类型；
  5. }

rect：

  • 类型：JSON 对象
  • 描述：（可选项）模块的位置及尺寸
  • 内部字段：
  1. {
  2.     x: 0,   //（可选项）数字类型；模块左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认：0
  3.     y: 0,   //（可选项）数字类型；模块左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认：0
  4.     w: 320, //（可选项）数字类型；模块的宽度；默认：'auto'
  5.     h: 200  //（可选项）数字类型；模块的高度；默认：'auto'
  6. }

fixedOn：

  • 类型：字符串类型
  • 描述：（可选项）模块视图添加到指定 frame 的名字（只指 frame，传 window 无效）
  • 默认：模块依附于当前 window

fixed:

  • 类型：布尔
  • 描述：（可选项）模块是否随所属 window 或 frame 滚动
  • 默认值：true（不随之滚动）

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       status:    //布尔类型；加入房间是否成功
  3. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.enterRoom({
  3.      rect:{
  4.        x:,
  5.        y:,
  6.        w:,
  7.        h:
  8.      },
  9.      fixedOn:'',
  10.      fixed:,
  11.      roomModel:{
  13.      }
  14. },function(ret) {
  15.    api.alert({msg:JSON.stringify(ret)});
  16. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

showRoom

显示房间视频区域

showRoom()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.showRoom();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hideRoom

隐藏房间视频区域

hideRoom()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.hideRoom();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

closeRoom

关闭房间视频区域

closeRoom()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.closeRoom();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

exitRoom

销毁房间, 离开房间时务必调用, 否则会影响之后的逻辑

exitRoom()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.exitRoom();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

startGamePlayer

开始播放娃娃机视频流换面

startGamePlayer()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.startGamePlayer();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

stopGamePlayer

停止播放娃娃机视频流换面

stopGamePlayer()

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.stopGamePlayer();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestStartGame

特别注意: 在调用此接口前, 请确保用户信息已经注入到SDK用户信息回调中, 否则上机操作会直接失败

requestStartGame(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,             //数字类型；状态码
  3.       message: ''         //布尔类型；是否获取成功
  4.       orderID: ''         //布尔类型；是否获取成功
  5. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestStartGame(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestOperation

游戏操作, 上下左右操作

requestOperation({params},callback(ret))

params

direction：

  • 类型：字符串
  • 描述：（可选项）方向
  • 默认：up
  • 取值范围：
    • none：未知
    • up：
    • down：
    • left：
    • right：
    • confirm：下抓

type：

  • 类型：字符串
  • 描述：（可选项）操作类型
  • 默认：click
  • 取值范围：
    • click：点击
    • longPress：长按
    • release：抬起
    • reverse：撤销长按

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,          //数字类型；状态码    
  3.       msg: ‘’          //字符串类型；请求信息
  4. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestOperation({
  3.     direction: 'up',
  4.     type: longpress
  5. },function(ret){
  6.    api.alert({msg:JSON.stringify(ret)});
  7. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestClawWithForceRelease

游戏下爪操作

注: 下爪操作涉及到硬件上的判断娃娃到底有没有抓到, 所以结果回调需要相对较长的时间

参数说明: 要不要强制释放上机锁定(例如:用户点击了下爪之后,在结果回来之前就离开了房间,就放弃了再来一局的机会,需要传入YES来释放等待用户8s选择是否再来一局的必要)

requestClawWithForceRelease({params},callback(ret))

params

forceRelease：

  • 类型：布尔
  • 描述：（可选项）是否强制释放上机锁定
  • 默认：false

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,          //数字类型；状态码
  3.       message: ''      //字符串类型；信息     
  4.       resultModel: {   //JSON对象；抓取的结果
  5.          ID:,          //数字类型；id
  6.          dateline:,    //字符串类型；时间
  7.          orderId:,     //字符串类型；订单号
  8.          uid:,         //数字类型；用户ID
  9.          rid:,         //数字类型；rid
  10.          playTimes:,   //数字类型；上机时间
  11.          clawTimes:,   //数字类型；游戏(摇爪操作)时间
  12.          video:,       //字符串类型；游戏视频
  13.          coin:,        //数字类型；奖励
  14.          awardFishball:,//数字类型；奖励
  15.          state:,        //数字类型；状态, 0，1失败，2成功
  16.          stage:,        //数字类型；-1上机失败，1:上机中，2:摇杆中, 3:下抓中, 4:游戏结束, 5: 游戏申述
  17.          wawaSuccess:,  //数字类型；已有多少人抓住了娃娃
  18.          wawa:{         //JSON对象；抓取的娃娃信息
  19.             ID:,        //数字类型；娃娃 ID
  20.             flag:,      //数字类型；按位与运算，0位标识是否新品娃娃，1位标识是否热门
  21.             coin:,      //数字类型；所需金币
  22.             name:,      //字符串类型；娃娃名称
  23.             icon:,      //字符串类型；娃娃价值
  24.             pic:        //字符串类型；娃娃缩略图
  25.          }
  26.       }          
  27. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestClawWithForceRelease({
  3.     forceRelease: true
  4. },function(ret){
  5.    api.alert({msg:JSON.stringify(ret)});
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

sendDamuMsg

发送弹幕

sendDamuMsg({params})

params

msg：

  • 类型：字符串
  • 描述：要发送的字符串

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.sendDamuMsg({
  3.     msg:‘抓啊！’ 
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

requestQuickOnBoard

快速上机请求, 无需传入参数, 会根据当前的机器空闲情况自动为用户分配可使用的机器

特别注意: 在调用此接口前, 请确保用户信息已经注入到SDK用户信息回调中, 否则上机操作会直接失败

requestQuickOnBoard(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：信息
  • 内部字段：
  1. {
  2.       code: ,          //数字类型；状态码  
  3.       message: ‘’      //字符串类型；请求信息
  4.       room: {          //JSON对象； 游戏房间描述对象
  5.          ID:,             //数字类型；房间ID
  6.          state: ,         //数字类型；房间状态: 小于1:故障 1：补货 2:空闲 大于2:游戏中
  7.          uid: ,           //数字类型； 在玩的人uid
  8.          streamMaster:,   //字符串类型；
  9.          streamSlave:,    //字符串类型；
  10.          wawa:{           //JSON对象；玩具描述
  11.             ID: ,         //数字类型；娃娃ID
  12.             flag: ,       //数字类型；按位与运算，0位标识是否新品娃娃，1位标识是否热门
  13.             coin:,        //数字类型；所需金币
  14.             name:,        //字符串类型；娃娃名称
  15.             icon:,        //字符串类型；娃娃价值
  16.             pic:          //字符串类型；娃娃缩略图
  17.          },      
  18.          userModel: {     //JOSN对象；玩儿家信息描述
  19.              uid:,         //数字类型；用户ID
  20.              gender:,      //数字类型；性别, 1男 0女
  21.              portrait:,    //字符串类型；头像
  22.              nickname:,    //字符串类型；昵称
  23.              spoils:,      //字符串类型；战利品个数
  24.           }   
  25.       }
  26. }

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.requestQuickOnBoard(function(ret){
  3.    api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

cameraSwitchIsFront

切换摄像头

cameraSwitchIsFront({params})

params

isFront：

  • 类型：布尔
  • 描述：（可选项）是否要切换到正面摄像头, 传入true会切换到正面摄像头, 传入false则会切换到侧面摄像头
  • 默认：true

示例代码

  1. var wawa = api.require('wawa');
  2. wawa.cameraSwitchIsFront({
  3.     isFront: true 
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addEventListener

添加监听

addEventListener({params},callback(ret,err))

params

name：

  • 类型：字符串
  • 描述：指定监听的行为

  • 取值范围：

    • userInfoError：用户信息错误事件

    • roomListChange：当前房间列表首页数据有变化

    • viewerListChange：当前进入房间的观众列表数据有变化

    • gameManagerError：游戏管理器错误信息事件

    • onMasterStreamReady：主摄像头的流已经加载成功了

    • onSlaveStreamReady：辅摄像头的流已经加载成功了

    • reciveRemoteMsg：收到聊天回调

    • reciveWatchNumber：收到 观看人数

    • reciveRoomUpdateData：收到 房间状态更新
    • reciveClawResult：房间内收到 抓娃娃结果通知
    • reciveGlobleMessage：收到全平台 抓娃娃结果通知
    • avatarTtlDidChanged：ping游戏服务器延迟变更, 没2s ping一次

callback(ret,err)

ret：

  • 类型：JSON对象
  • 描述：监听结果，当name 为onMasterStreamReady和onSlaveStreamReady时，仅回调事件，无任何参数
  • 内部字段：
  1. {
  2.      userInfoErrCode:1    //数字类型；用户信息错误码，仅当name 为 userInfoErr、gameManagerError时本字段有值
  3.                           //-1：未知错误
  4.                           //0：未登录
  5.                           //1：财富信息不足
  7.      roomModels:[]        //数组类型；同requestRoomListByIds接口返回的数据结构一致，仅当name 为roomListChange 时有值
  9.      userModels:[{        //数组类型；仅当name 为viewerListChange 时有值
  10.              uid:,         //数字类型；用户ID
  11.              gender:,      //数字类型；性别, 1男 0女
  12.              portrait:,    //字符串类型；头像
  13.              nickname:,    //字符串类型；昵称
  14.              spoils:,      //字符串类型；战利品个数
  15.       }]        
  17.       chatModel:{         //JSON对象；远端聊天信息，仅当name 为 reciveRemoteMsg 时本字段有值
  18.          content: '',     //字符串类型；发言内容
  19.          fromUser:{       //JSON对象；发信息的用户
  20.              uid:,         //数字类型；用户ID
  21.              gender:,      //数字类型；性别, 1男 0女
  22.              portrait:,    //字符串类型；头像
  23.              nickname:,    //字符串类型；昵称
  24.              spoils:,      //字符串类型；战利品个数
  25.          },
  26.          mentions:[{      //JSON对象；@的用户
  27.              uid:,         //数字类型；用户ID
  28.              gender:,      //数字类型；性别, 1男 0女
  29.              portrait:,    //字符串类型；头像
  30.              nickname:,    //字符串类型；昵称
  31.              spoils:,      //字符串类型；战利品个数
  32.          }]
  33.       }
  35.       number:              //数字类型；收到的观看人数，仅当name 为reciveWatchNumber时有值
  37.       liveData:{           //JSON对象；房间状态更新数据，仅当 name为reciveRoomUpdateData时有值
  38.          streamPlayer:,    //字符串类型；上机者流地址(暂未提供游戏者推流)
  39.          user:{},          //JSON对象；同requestUserInfo接口返回值一致
  40.          state:            //数字类型；取值范围如下：
  41.                            //-100:机器回收
  42.                            //-1:机器下架
  43.                            //0:机器故障
  44.                            //:补货中
  45.                            //2: 空闲
  46.                            //3:开始游戏
  47.                            //4: 移动中
  48.                            //5:下抓(等待结果)
  49.                            //6: 等待重新上机
  50.       }
  51.       result:{             //JSON对象；房间内收到 抓娃娃结果，仅当name 为reciveClawResult时有值
  52.          status:,          //数字类型；1:未抓中; 2:抓中; 
  53.          user{}            //JSON对象；同requestUserInfo接口返回值一致
  54.       }
  55.       message:             //字符串类型；收到全平台 抓娃娃结果，仅当name 为reciveGlobleMessage时有值
  56.       ttl:                 //数字类型；ping游戏服务器延迟变更，仅当name 为avatarTtlDidChanged时有值
  57. }

示例代码

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

removeEventListener

移除监听

removeEventListener({params},calback(ret))

params

name：

  • 类型：字符串
  • 描述：指定监听的行为

  • 取值范围：

    • userInfoError：用户信息错误事件

    • roomListChange：当前房间列表首页数据有变化

    • viewerListChange：当前进入房间的观众列表数据有变化

    • gameManagerError：游戏管理器错误信息事件

    • onMasterStreamReady：主摄像头的流已经加载成功了

    • onSlaveStreamReady：辅摄像头的流已经加载成功了

    • reciveRemoteMsg：收到聊天回调

    • reciveWatchNumber：收到 观看人数

    • reciveRoomUpdateData：收到 房间状态更新
    • reciveClawResult：房间内收到 抓娃娃结果通知
    • reciveGlobleMessage：收到全平台 抓娃娃结果通知
    • avatarTtlDidChanged：ping游戏服务器延迟变更, 没2s ping一次
  1. var wawa = api.require('wawa');
  2. wawa.removeEventListener({
  3. });

可用性

iOS系统，Android系统