获取信息-拓展功能
获取信息-拓展功能
更新时间：2025-04-02 08:04

# 1 功能介绍

该部分用于获取一些SDK的基础信息，根据具体使用场景选择将接入即可

# 2 前置条件

拓展功能在接入前必须保证已经完成快速接入,否则部分接口会返回空值

# 3 接入步骤

# 3.1 iOS渠道相关信息获取方法

# 3.2 Android渠道相关信息获取方法

# 3.3 分享功能

概述

该功能适用于游戏中进行图片分享，调用后可拉起用户分享界面

前置条件

拓展功能在接入前必须保证已经完成快速接入,否则可能会出现调用不成功，分享无法弹出分享界面等问题

调用方法


public void share(ShareInfo shareInfo)
1
2
3

调用示例


ShareInfo shareInfo = new ShareInfo();
shareInfo.hasUi = true;
shareInfo.title = "Unity测试分享";
shareInfo.content = "Unity测试描述";
shareInfo.imgPath = "https://open.ultra.com";
shareInfo.imgUrl = "https://open.ultra.com";
shareInfo.url = "https://www.baidu.com/";
shareInfo.shareTo = "3";
shareInfo.extenal = "extenal";
UltraSDK.getInstance().share(shareInfo);
1
2
3
4
5
6
7
8
9
10
11
12

[!WARNING|label:说明：] 注意:以上为测试demo数据，正式环境中需要游戏填写真实参数

  • 参数说明
方法 说明 类型 重要性
hasUi 是否包含界面分享 bool 必须
title 分享标题 string 必须
content 分享内容 string 必须
imgPath 图片本地地址[与imgUrl二选一] string 必须
imgUrl 图片网络地址[与imgPath二选一] string 必须
url 链接URL string 必须
shareTo 分享到 [1-微信好友，2-微信朋友圈，3-QQ，4-QQ空间] string 必须
extenal 额外备注 string 非必须

# 3.4 自定义埋点位

场景介绍

研发自定义埋点位置，进行自主调用

参数说明

字段 类型 重要 说明
eventName string 必填 事件名称
parameters Dictionary<string,string> 可以为空 自定义事件内容

调用方法


 public void SendEvent(string eventName,Dictionary<string,string> parameters=null)
1
2
3

调用示例


        Dictionary<string, string> dic = new Dictionary<string, string>();
        dic.Add("uid","123456");
        UltraSDK.Instance.SendEvent("Text", dic);
1
2
3
4
5

# 3.5 adjust自定义埋点位

场景介绍

研发使用adjust自定义埋点位置，进行自主调用

参数说明

字段 类型 重要 说明
customEvent string 必填 adjust后台事件名称对应的 密钥
parameters Dictionary<string,string> 可以为空 自定义事件内容

调用方法


 public void AdjustEvent(string customEvent,Dictionary<string,string> parameters=null)
1
2
3

调用示例


        Dictionary<string, string> dic = new Dictionary<string, string>();
        dic.Add("uid","123456");
        UltraSDK.Instance.AdjustEvent("密钥", dic);
1
2
3
4
5

# 3.6 支付埋点位

场景介绍

研发可以自行在想要的支付位置进行自定义埋点

注 ：firebase SDK 未提供专门的支付上报接口，所以调用此接口，firebase 无效

facebook 与 firebase SDK 在默认情况下会自动采集支付上报事件，无需主动上报支付埋点事件

参数说明

字段 类型 重要 说明
orderId String 必填 订单号
amount double 必填 金额
currency String 必填 币种 CNY
parameters Dictionary<string,string> 可以为空 自定义事件内容

调用方法


 LogPurchase(string orderId, double amount, string currency,Dictionary<string,string> paramter=null)
1
2
3

调用示例


        UltraSDK.Instance.LogPurchase("订单号", 12.0, "USD",null);
1
2
3

# 3.7 屏蔽市场融合SDK默认埋点

场景介绍

市场融合SDK的埋点位置，可能游戏不需要，可做屏蔽处理 Android独有

参数说明

字段 类型 重要 说明
bundle Dictionary<MARKET_EVENT, bool> 必填 屏蔽内容

bundle参数说明

key 类型 value 类型 说明
MARKET_ALL String true,false boolean 除激活以外全部屏蔽
MARKET_REGISTER_SUCCESS String true,false boolean 屏蔽注册
MARKET_LOGIN_SUCCESS String true,false boolean 屏蔽登录成功
MARKET_LOGIN_FAILED String true,false boolean 屏蔽登录失败
MARKET_LOGIN_CANCEL String true,false boolean 屏蔽取消登录
MARKET_LOGOUT_SUCCESS String true,false boolean 屏蔽注销
MARKET_PAY_SUCCESS String true,false boolean 屏蔽支付成功
MARKET_PAY_FAILED String true,false boolean 屏蔽支付失败
MARKET_PAY_CANCEL String true,false boolean 屏蔽取消支付
MARKET_BEFORE_PAY String true,false boolean 屏蔽下单前

调用方法


 public void SetDisableEvent(Dictionary<MARKET_EVENT, bool> bundle)
1
2
3

调用示例


         Dictionary<MARKET_EVENT, bool> bundle = new Dictionary<MARKET_EVENT, bool>();
        bundle.Add(MARKET_EVENT.MARKET_ALL, false);
        UltraSDK.Instance.SetDisableEvent(bundle);
1
2
3
4
5

# 3.8 注销账号（账号删除）

场景介绍

  • 根据最新网信部政策要求，游戏必须拥有「注销账号」流程
  • 接入该接口游戏需要自绘按钮，按钮点击后调用此接口即可

接入建议

由于注销账号需要获取玩家账号信息，建议将注销账号功能接入在游戏登陆后，例如：游戏设置页面、玩家信息界面等

调用方法


AccountCancellation(UltraAccountDeleteProxy.AccountDeleteDelegateProxy accountDeleteDelegateProxy);
1
2
3

调用示例


       UltraSDK.Instance.AccountCancellation((code, msg) =>
        {
            if (code == UltraSDKResult.UltraSDKResultSuccess)
            {
                //成功
                //将游戏退出到登录页面，处于未登录状态（cp自主操作）
                showLog("删除账号成功", msg);
            }
            else if (code == UltraSDKResult.UltraSDKResultCancel)
            {
                //失败
                //玩家在注销账号页面点击取消
                showLog("删除取消成功", msg);
            }
        });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 3.9 反注销自定义回调监听

场景介绍

* 此接口针对cp方想自主监听账号删除结果，可以进行调用
* 如果有设置此接口，原本默认的回调流程将会被覆盖，只回调此监听器

接入建议

此接口务必在调用 3.8 注销账号（账号删除） 接口之前调用，否则可能不可用。

调用方法


AccountUnCancellation(UltraAccountUnCancellationDelegateProxy.AccountUnCancellationDelegateProxy
                accountUnCancellationDelegateProxy);
1
2
3
4

调用示例


         UltraSDK.Instance.AccountUnCancellation((code, msg) =>
        {
            if (code == UltraSDKResult.UltraSDKResultSuccess)
            {   
                //成功
                //将游戏退出到登录页面，处于未登录状态（cp自主操作）
                showLog("onCancelZhuXiaoAction Success", msg);
            }
            else
            {
                //失败
                //玩家在注销账号页面点击取消
                showLog("onCancelZhuXiaoAction Fail", msg);
            }
        });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
本文档对解决你的问题有所帮助？
本页目录