热云 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实例ReyunAPIapi = null;
try {
api = ReyunAPI.getInstance("1edf4b9540a5e83c0febf1f4ac407224");
} catch (AppidNotValidExceptione) {
e.printStackTrace();
}
Resultresult = null;
try {
result = api.createInstall()
// 设置install参数
.setDeviceid("xxxxxxxxxx")
.setChannelid("appstore")
// 报送install数据
.post();
} catch (ConnectExceptione) {
e.printStackTrace();
} catch (ReyunTimeoutExceptione) {
e.printStackTrace();
} catch (IOExceptione) {
e.printStackTrace();
} catch (ParamRequiredExceptione) {
e.printStackTrace();
} catch (ContextSizeTooLongExceptione) {
e.printStackTrace();
}
// 输出返回结果System.out.println(result.getMessage());