快速集成

完成Unity SDK的接入工作后，调用以下方法。

初始化

初始化SDK

GameSambaSDK.InitializeSdk();

设置

设置语言

API

GameSambaSDK.SetLanguage(string language);

参数

参数	类型	必须	描述
language	string	是	语言

language 参数说明

相关类 GameSambaSDKLanguage ：

语言（lang）	描述
LANG_EN	英文
LANG_CN	简体中文
LANG_TW	繁体中文
LANG_FR	法文
LANG_TH	泰文
LANG_KO	韓文

例子

GameSambaSDK.SetLanguage(GameSambaSDKLanguage.LANG_TW);

设置Debug模式

API

GameSambaSDK.SetDebug(bool isDebug);

参数

参数	类型	必须	描述
isDebug	bool	是	是否是Debug模式

例子

GameSambaSDK.SetDebug(true);

设置支持的帐号类型

API

GameSambaSDK.SetSupportAccount(bool isSupportGamesamba, bool isSupportGoogle, bool isSupportFacebook);

参数

参数	类型	必须	描述
isSupportGamesamba	bool	是	是否支持Gamesamba登录
isSupportGoogle	bool	是	是否支持Google登录
isSupportFacebook	bool	是	是否支持Facebook登录

例子

GameSambaSDK.SetSupportAccount(false, true, true);

设置是否支持切换帐号（默认开启）

API

GameSambaSDK.SetSupportSwitchAccount(bool isSupport);

参数

参数	类型	必须	描述
isSupport	bool	是	是否支持账号切换

例子

GameSambaSDK.SetSupportSwitchAccount(true);

设置内购商品列表（iOS需要）

API

GameSambaSDK.SetIAPItems(string[] itemsIDArray);

参数

参数	类型	必须	描述
itemsIDArray	string[]	是	内购商品ID数组

例子

string[] array = { "ipa.aot.na001", "ipa.aot.na002", "ipa.aot.na003" };
GameSambaSDK.SetIAPItems(array);

登录

登录游客账号

API

GameSambaSDK.LoginGuest();

登录Facebook账号

API

GameSambaSDK.LoginFacebook();

登录Google账号

API

GameSambaSDK.LoginGoogle();

登录GameSamba账号

API

GameSambaSDK.LoginGameSamba();

登录IOS游戏中心

API

GameSambaSDK.LoginGameCenter();

登录成功后设置

登录帐号成功后，选择游戏服务器，选择游戏角色后，需要调用以下方法设置服务器和角色信息。

设置服务器信息

API

GameSambaSDK.SetServerInfo(string serverId, string serverName);

参数

参数	类型	必须	描述
serverId	string	是	服务器ID
serverName	string	是	服务器名称

例子

string serverId = "1"; //服务器ID
string serverName = "test"; //服务器名称
GameSambaSDK.SetServerInfo(serverId, serverName);

设置角色信息

API

GameSambaSDK.SetRoleInfo(string roleId, string roleName);

参数

参数	类型	必须	描述
roleId	string	是	角色ID
roleName	string	是	角色名称

例子

string roleId = "1"; //角色ID
string roleName = "user"; //角色名称
GameSambaSDK.SetRoleInfo(roleId, roleName);

悬浮框

登录帐号成功后，再登录游戏角色，之后再去调用显示悬浮框。

显示悬浮气泡框

API

GameSambaSDK.ShowPop();

隐藏悬浮气泡框

API

GameSambaSDK.HidePop();

设置悬浮气泡框位置

API

GameSambaSDK.SetPopPosition(PopDirection direction, float yPercentage);

参数

参数	类型	必须	描述
direction	PopDirection	是	悬浮框方向（左边，右边）
yPercentage	float	是	Y轴位置，屏幕高度的百分比，上方为0，下方为1

例子

 //设置悬浮框初始位置, iPhone注意避开刘海范围
 GameSambaSDK.SetPopPosition(PopDirection.Left, 0.3f); 

设置悬浮气泡框支持功能

API

GameSambaSDK.SetPopSupportFunction(bool isOpenShare, bool isOpenFeedback, bool isOpenDiscord);

参数

参数	类型	必须	描述
isOpenShare	bool	是	否显示分享功能
isOpenFeedback	bool	是	是否显示客服功能
isOpenDiscord	bool	是	是否显示Discord

例子

//设置悬浮功能开启
GameSambaSDK.SetPopSupportFunction(false, true, true); 

分享

分享链接到Facebook

API

GameSambaSDK.ShareFacebookLink(string shareLink, string quote);

参数

参数	类型	必须	描述
shareLink	string	是	分享链接
quote	string	是	引用文字

例子

string shareLink = "http://tg.gamesamba.com";
string quote = "这是一条引文";
GameSambaSDK.ShareFacebookLink(shareLink, quote);

分享图片文件到Facebook

API

GameSambaSDK.ShareFacebookImage(string imagePath);

参数

参数	类型	必须	描述
imagePath	string	是	图片文件本地路径

例子

String imagePath = "/storage/emulated/0/game321/image.png";
GameSambaSDK.ShareFacebookImage(imagePath);

内购

谷歌内购

API

GameSambaSDK.PurchaseGoogle(string itemId);

参数

参数	类型	必须	描述
itemId	string	是	商品ID

例子

string itemId = "ipa.tg.na002"; //商品ID
GameSambaSDK.PurchaseGoogle(itemId);

苹果内购

API

GameSambaSDK.PurchaseApple(string itemId);

参数

参数	类型	必须	描述
itemId	string	是	商品ID

例子

string itemId = "ipa.tg.na002"; //商品ID
GameSambaSDK.PurchaseApple(itemId);

第三方内购

API

GameSambaSDK.PurchaseThird(string itemId);

参数

参数	类型	必须	描述
itemId	string	是	商品ID

例子

string itemId = "ipa.tg.na002"; //商品ID
GameSambaSDK.PurchaseThird(itemId);

事件统计

设置客户用户ID

描述

可以帮助您交叉引用自己的独有 ID 以及 AppsFlyer 的独有 ID 和其他设备的 ID。该 ID 与回传 IP 一同出现在 AppsFlyer CSV 报告中，用于与您的内部 ID 交叉引用。

API

GameSambaSDK.SetUserId(string userId);

参数

参数	类型	必须	描述
userId	string	是	用户ID

例子

string userId = "123";
GameSambaSDK.SetUserId(userId);

记录统计事件

API

GameSambaSDK.RecordEvent(string eventName, IDictionary<string, string> parameters = null);

参数

参数	类型	必须	描述
eventName	string	是	事件名称，注意：应用内事件名称长度不得超过 45 个字符
parameters	Dictionary	否	记录内容（字典）

例子

string eventName = "Test";
Dictionary<string, string> evetParams = new Dictionary<string, string>();
evetParams.Add("id", "1");
evetParams.Add("level", "1");
GameSambaSDK.RecordEvent(eventName, evetParams);

追踪购买事件

API

GameSambaSDK.RecordPurchaseEvent(string itemId, string itemType, float revenue, string currencyCode);

参数

参数	类型	必须	描述
itemId	string	是	商品ID
itemType	string	是	商品类型
revenue	float	是	收入
currencyCode	string	是	货币单位（ISO 4217 代码） 例如"USD","HKD","CNY","TWD"等 参考：https://www.xe.com/iso4217.php

例子

string itemId = "good1"; //商品ID
string itemType = "good"; //商品类型
float revenue = 2.99f; //商品价格
string currencyCode = "USD"; //货币单位
GameSambaSDK.RecordPurchaseEvent(itemId, itemType, revenue, currencyCode);

记录GoogleAnalysis事件

API

GameSambaSDK.RecordGAEvent(string eventName, IDictionary<string, string> parameters = null);

参数

参数	类型	必须	描述
eventName	string	是	事件名称，注意：应用内事件名称长度不得超过 45 个字符
parameters	Dictionary	否	记录内容（字典）

例子

string eventName = "Test";
Dictionary<string, string> evetParams = new Dictionary<string, string>();
evetParams.Add("id", "1");
evetParams.Add("level", "1");
GameSambaSDK.RecordGAEvent(eventName, evetParams);