Skip to content

Reyun/reyun-java

Folders and files

NameName
Last commit message
Last commit date

Latest commit

822cef2 · Aug 18, 2015

History

87 Commits
Nov 14, 2014
Aug 18, 2015
Nov 28, 2013
Dec 16, 2013
Aug 18, 2015
Aug 18, 2015

Repository files navigation

热云 Java sdk

游戏运营支撑平台

http://game.reyun.com

SDK接口方法和参数说明及注意事项(必读)

  • 申请appid,打开http://game.reyun.com,使用您的热云账号登陆后在**【我的游戏】管理后台,点击【添加游戏】**,在弹出的面板中创建新游戏,完成后您将获得一个32位的16进制APPID,用来唯一标识您刚刚创建的游戏。
    注:为了保证您的数据安全,请勿泄露您的APP ID给其他人。
  • deviceid是很重要的参数,是用来记录用户设备的身份信息(ios获取的是openudid或idfa,android获取IMEI或者mac地址,但要保证一致),如果有个别用户出现获取不到deviceid的情况,deviceid要传unknown。
  • 文档中的是否必填项是决定数据是否报送成功的选项,必填参数没有填写会导致数据报送不出来,不是不是必填参数就不是重要参数,(如果必填参数获取不到,请用unknown代替)例如以下参数:
  • channelid是区分渠道的重要参数,是记录用户来源的信息
  • serverid是多服游戏的重要参数,通过serverid来统计每个游戏的服各指标数据,同一个服的各项参数要有相同的serverid,除install和startup参数以外,其他参数都要有serverid。
  • level也是必填参数,除install,stastup,register不用填充写level
  • 在玩家首次进入某个服务器调用,报送register接口数据(也就是说每次进入新服都需要发送register接口,并且同时发送loggedin接口), 要确保参数who不能为空(有平台的记录平台ID,没有平台的只要用户ID唯一就可以了,也就是用户进所有服务器只有一个ID) 。用户每进入一个新服发送且仅发送一次register。

Maven

<dependency>
    <groupId>com.reyun</groupId>
    <artifactId>reyun-java</artifactId>
    <version>2.2.0</version>
</dependency>

sdk使用

报送数据至rest接口

// 获得报送rest接口的ReyunAPI实例
ReyunAPI api = null;
try {
    api = ReyunAPI.getInstance("1edf4b9540a5e83c0febf1f4ac407224");
} catch (AppidNotValidException e) {
    e.printStackTrace();
}

Result result = null;
try {
	result = api.createInstall()

	// 设置install参数
	.setDeviceid("xxxxxxxxxx")
	.setChannelid("appstore")
	
	// 报送install数据
	.post();
} catch (ConnectException e) {
    e.printStackTrace();
} catch (ReyunTimeoutException e) {
    e.printStackTrace();
} catch (IOException e) {
    e.printStackTrace();
} catch (ParamRequiredException e) {
    e.printStackTrace();
} catch (ContextSizeTooLongException e) {
    e.printStackTrace();
}

// 输出返回结果
System.out.println(result.getMessage());