掌趣PC扫码登录SDK

1.文档说明

1.1 功能描述

此文档主要是用于在游戏PC客户端接入扫码功能。

1.2 阅读对象

接入掌趣扫码SDK的游戏UNITY客户端开发者。

3.特别说明

SDK使用引擎unity 2017.4.17版本开发。
暂时不支持在编辑器里面调试,只能编译成EXE以后使用。
暂时不支持64位编译。请使用X86编译。

2.使用说明

2.1 参数配置

开发者需要在掌趣平台获取配置文件,并把配置文件放到Assets/Resources/ 目录下。

2.2 初始化接口

2.2.1 接口说明

需要在调用登录之前调用初始化接口。

2.2.2 接口使用

  1. OurpalmSDK.GetInstance().init();

2.3 登录接口

2.3.1 接口说明

请务必在初始化之后调用。

2.3.2 接口使用

  1. OurpalmSDK.GetInstance().OurpalmLogin();

2.4 登录成功事件

2.4.1 接口说明

登录成功以后被调用, 此事件被调用时,登录页面也会被自动关闭。
开发者拿到数据后,请勿直接使用。需要调用服务端验证接口验证,使用服务端数据为准。

2.4.2 接口定义

  1. /**
  2. *@param data 成功以后返回的用户数据.json格式
  3. */
  4. private void Ourpalm_LoginSuccess(string data)

2.4.3 接口使用说明

  1. // 注册事件
  2. OurpalmSdkCallBack.Ourpalm_LoginSuccess += Ourpalm_LoginSuccess;
  3. //取消事件
  4. OurpalmSdkCallBack.Ourpalm_LoginSuccess -= Ourpalm_LoginSuccess;
  5. // 事件实现
  6. private void Ourpalm_LoginSuccess(string data){
  7. Debug.Log("Ourpalm_LoginSuccess data = " + data);
  8. }

2.5 登录失败事件

2.5.1 接口说明

登录失败以后被调用。
此事件被调用时,登录页面也会被自动关闭。

2.5.2 接口定义

  1. /**
  2. * @param code 登录失败code,
  3. * @param data 错误信息。
  4. */
  5. private void Ourpalm_LoginFail(int code,string data)

2.5.3 接口使用说明

  1. // 注册事件
  2. OurpalmSdkCallBack.Ourpalm_LoginFail += Ourpalm_LoginFail;
  3. //取消事件
  4. OurpalmSdkCallBack.Ourpalm_LoginFail -= Ourpalm_LoginFail;
  5. // 事件实现
  6. private void Ourpalm_LoginFail(int code, string data){
  7. Debug.Log("Ourpalm_LoginFail code = " + code + " data = " + data);
  8. }

2.6 支付接口

2.6.1 接口说明

请务必在登录接口之后调用。

2.6.2 接口定义

  1. /**
  2. * 支付接口
  3. *
  4. * @param propId
  5. * 游戏自定义的商品ID
  6. * @param chargeCash
  7. * 价格(以分为单位)
  8. * @param currencyType
  9. * 货币类型(1人民币2美元3日元4港币5英镑6新加坡币7越南盾8台币9韩元)
  10. * @param propName
  11. * 商品名称
  12. * @param propCount
  13. * 商品数量
  14. * @param propDes
  15. * 商品描述
  16. * @param Gameurl
  17. * 游戏发货地址(如游戏未传,则使用在平台配置的地址进行发货通知)
  18. * @param ExtendParams
  19. * 扩展参数
  20. * @param serverId
  21. * 服务器Id
  22. * @param roleId
  23. * 角色Id
  24. * @param roleName
  25. * 角色名称
  26. * @param rolelv
  27. * 角色等级
  28. * @param roleviplv
  29. * 角色VIP等级
  30. */
  31. public void OurpalmPCPay(string propId, string chargeCash,
  32. string currencyType, string propName,
  33. string propCount, string propDes, string Gameurl,
  34. string ExtendParams, string serverId,
  35. string roleId, string roleName,
  36. string rolelv, string roleviplv)

2.6.3 接口使用

  1. mOurpalmSDK.OurpalmPCPay("0001", "1", "1",
  2. "测试-商品名称111", "100", "测试-商品描述11111", "", "测试-我是扩展参数",
  3. "10001", "role_123", "testrole1",
  4. "1", "1");

2.7 支付成功事件

2.7.1 接口说明

支付成功以后被调用, 此事件被调用时,会弹出支付成功页面。
收到此回调只表示支付流程结束,游戏是否发货要以服务端充值结果为准。

2.7.2 接口定义

  1. /**
  2. *支付成功回调
  3. * @param code 错误码
  4. * @param ssid 订单号
  5. * @param pbid 商品id
  6. */
  7. private void Ourpalm_PaySuccess(string code, string ssid, string opid)

2.7.3 接口使用说明

  1. // 注册事件
  2. OurpalmSdkCallBack.PaymentSuccess += Ourpalm_PaySuccess;
  3. //取消事件
  4. OurpalmSdkCallBack.PaymentSuccess -= Ourpalm_PaySuccess;
  5. // 事件实现
  6. private void Ourpalm_PaySuccess(string code, string ssid, string opid)
  7. {
  8. Debug.Log("Ourpalm_PaySuccess code = " + code + " ssid = " + ssid);
  9. mText.text = " 支付成功 code = " + code + " ssid = " + ssid;
  10. }

2.8 支付失败事件

2.8.1 接口说明

支付失败以后被调用。
此事件被调用时,支付页面也会被自动关闭。

2.8.2 接口定义

  1. /**
  2. *支付失败回调
  3. * @param code 错误码
  4. * @param ssid 订单号
  5. * @param pbid 商品id
  6. */
  7. private void Ourpalm_PayFail(string code, string ssid, string opid)

2.8.3 接口使用说明

  1. // 注册事件
  2. OurpalmSdkCallBack.PaymentFail += Ourpalm_PayFail;
  3. //取消事件
  4. OurpalmSdkCallBack.PaymentFail -= Ourpalm_PayFail;
  5. // 事件实现
  6. private void Ourpalm_PayFail(string code, string ssid, string opid)
  7. {
  8. Debug.Log("Ourpalm_PayFail code = " + code + " ssid = " + ssid);
  9. mText.text = " 支付失败 code = " + code + " ssid = " + ssid;
  10. }