- 申请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。
<dependency>
<groupId>com.reyun</groupId>
<artifactId>reyun-java</artifactId>
<version>2.2.0</version>
</dependency>
// 获得报送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());