我们如何去做?
- 在 libgdx的主页修改libgdx样本“superjumper".
- 使用 AppWarp Cloud将它转化为2个玩家的实时游戏.
- 本游戏将匹配玩家并且用户需要到达城堡来赢得游戏的胜利.
- 用户将获得其他用户成绩的实时反馈以增加了游戏的刺激性。
Eclipse 项目设置
接下来,您需要从这个git repository下载libgdx游戏样本(superjumper) 项目。.
在Eclipse中打开下载的superjumper解决方案。你将看到项目如下:
为了创建多玩家,我使用了 AppWarp Java SDK (1.5 as of now)
关于libgdx的依赖
正如 libgdx的官网上提到的,这个示例依赖于libgbx。如果你试图运行libgbx网站上的superjumper示例程序,你会得到关于gdx,gdx-backend-lwjgl, gdx-jnigen, gdx-openal的错误。你需要将这些工程设置为你的应用(superjumper)的依赖库工程来解决这些错误。
但我已经将这些库包含在了superjumper git仓库中的libs文件夹下。观看这个视频或阅读这个教程来了解更多关于libgdx工程的安装设置。
取得你的AppWarp application keys
如果你要与AppWarp云服务集成,你需要从ShepHertz开发者面板AppHq取得你的application keys.这些key能够在ShepHertz云服务中识别的你应用空间,而且AppWarp云需要用它们隔离不同应用间的消息。
在AppWarp网站上按步骤注册(免费)并取得你的application keys.
现在打开superjumper示例工程中的 WarpController.java 文件并在其中添加这些值。例如:
public static String AppKey = "14a611b4b3075972be364a7270d9b69a5d2b24898ac483e32d4dc72b2df039ef";
public static String SecretKey = "55216a9a165b08d93f9390435c9be4739888d971a17170591979e5837f618059";
运行多用户sample
既然你已经准备好了, 我们可以实际运行并观察这个游戏了。因为这个游戏有单人或多人游戏的选项,为了玩多人游戏你需要在2个模拟器/设备上同时运行它。
当你按了multiplayer按扭, 这个游戏会连接AppWarp并加入一个游戏房间。一旦进入这个游戏房间, 这个客户端在游戏开始前会一直等待第二个玩家加入该房间。
现在你需要在第二个模拟器/设备上做同样的操作,AppWarp的匹配API会将第二个玩家连接到相同的游戏房间,然后游戏开始。玩家需要到达城堡来完成这个游戏。同时用户会发现他们的对手在实时地运动。这个游戏内实时通信正是AppWarp的强大之处。
游戏会在这三个条件下完成
用户离开:当一个玩家离开游戏时,另一个玩家被判定为胜利者。因为他的对手已经离开的游戏。
闯关成功:到达城堡的玩家成为胜利者
游戏结束:如果玩家碰到了松鼠或者玩家掉了下来那另一个玩家会成为胜利者。
怎样与AppWarp集成
开始游戏
首先你需要用你的应用密钥初始化Warpclient单例(WarpController.java).
WarpClient.initialize(apiKey, secretKey);
接下你需要连接到AppWarp云端并且加入一个游戏房间(WarpController.java)
注意: AppWarp SDK 提供通过异步API提供它的功能。这意味着你只需简单的将请求监听器添加到WarpClient实例中区接受响应和通知即可。
这个文件 (WarpController.java) 有我们这步所需的所有代码。它创建连接请求,房间请求,区域请求(如果有必要创建一个房间)。因此我们添加相关监听器到OnStart()方法中。
public WarpController()
{
initAppwarp();
warpClient.addConnectionRequestListener(new ConnectionListener(this));
warpClient.addChatRequestListener(new ChatListener(this));
warpClient.addZoneRequestListener(new ZoneListener(this));
warpClient.addRoomRequestListener(new RoomListener(this));
warpClient.addNotificationListener(new NotificationListener(this));
}
private void initAppwarp(){
try {
WarpClient.initialize(apiKey, secretKey);
warpClient = WarpClient.getInstance();
} catch (Exception e) {
e.printStackTrace();
}
}
设置好listener后我们可以继续创建连接。用户需要传入一个惟一用户名(username)以连接到AppWarp云。在示例中我只是使用了一个随机字符串(你也可以从用户或像facebook的第三方服务处取得来惟一标识用户)。随机字符串是在MainMenuScreen.java文件中生成的。
WarpClient.connectWithUserName(userName);
连接的结果会交给以下回调函数。
public void onConnectDone(ConnectEvent e) {
if(e.getResult()==WarpResponseResultCode.SUCCESS){
callBack.onConnectDone(true);
}else{
callBack.onConnectDone(false);
}
}
public void onConnectDone(boolean status){
if(status){
warpClient.initUDP();
warpClient.joinRoomInRange(1, 1, false);
}else{
isConnected = false;
handleError();
}
}
如果连接成功,我们会试着加入一个房间。我们也可以选择初始化UDP(稍后的游戏玩家会用到)。为了加入房间,我们使用JoinRoomInRange方法并传入参数(1,1),它会请求服务器将客户端加入只有一个用户的房间。如果失败我们会新建并加入一个容纳两个玩家的房间。
public void onJoinRoomDone(RoomEvent event){
if(event.getResult()==WarpResponseResultCode.SUCCESS){// success case
this.roomId = event.getData().getId();
warpClient.subscribeRoom(roomId);
}else if(event.getResult()==WarpResponseResultCode.RESOURCE_NOT_FOUND){// no such room found
HashMap<string, object=""> data = new HashMap<string, object="">();
data.put("result", "");
warpClient.createRoom("superjumper", "shephertz", 2, data);
}else{
warpClient.disconnect();
handleError();
}
}
一旦加入某个房间(不管是现在还是创建新房间之后),客户端需要订阅这个房间来接收房间的通知(这在游戏中是必须的)。这里详细解释了这些概念。订阅之后我们要调用getLiveRoomInfo来检查房间是否有两个玩家了,如果是我们就开始游戏,否则就等待其他玩家加入这个房间。
WarpClient.getLiveRoomInfo(roomId);
public void onGetLiveRoomInfo(String[] liveUsers){
if(liveUsers!=null){
if(liveUsers.length==2){
startGame();
}else{
waitForOtherUser();
}
}else{
warpClient.disconnect();
handleError();
}
}
开始游戏
进行游戏的代码在MultiplayerGameScreen.java文件中。如果用户进入了这个界面,那就意味着有两个用户在这个房间中且游戏开始了。玩家玩这个游戏,并且他也要更新其他玩家的状态。其他玩家在你的界面上显示成绿色小怪物。
随着玩家在界面上移动以完成游戏关卡,需要绘制它的移动轨迹,也要将位置更新发送给远程玩家。参见WorldRenderer.java(multiplayer)
private void renderBob () {
{
...
...
if (side < 0){
batch.draw(keyFrame, world.local_bob.position.x + 0.5f, world.local_bob.position.y - 0.5f, side * 1, 1);
sendLocation(world.local_bob.position.x + 0.5f, world.local_bob.position.y - 0.5f, side * 1, 1);
}else{
batch.draw(keyFrame, world.local_bob.position.x - 0.5f, world.local_bob.position.y - 0.5f, side * 1, 1);
sendLocation(world.local_bob.position.x - 0.5f, world.local_bob.position.y - 0.5f, side * 1, 1);
}
}
消息通过我们在这个示例中所写的工具方法来发送。WarpClient允许客户端将字节数组广播给它所在的房间。可以使用TCP(默认)或UDP来发送。记住我们已经在成功连接到云服务后的第一个界面中初始化了UDP。
private void sendLocation(float x, float y, float width, float height){
try {
JSONObject data = new JSONObject();
data.put("x", x);
data.put("y", y);
data.put("width", width);
data.put("height", height);
WarpController.getInstance().sendGameUpdate(data.toString());
} catch (Exception e) {
// exception in sendLocation
}
}
发送给房间的消息是通过onUpdatePeersReceived的回调方法提供的。在这个回调中我们要解析这个消息并识别发送者,消息类型和与此消息绑定的数据。我们根据这些消息做相应的处理。
public void onUpdatePeersReceived(UpdateEvent event) {
callBack.onGameUpdateReceived(new String(event.getUpdate()));
}
try {
JSONObject data = new JSONObject(message);
float x = (float)data.getDouble("x");
float y = (float)data.getDouble("y");
float width = (float)data.getDouble("width");
float height = (float)data.getDouble("height");
renderer.updateEnemyLocation(x, y, width, height);
} catch (Exception e) {
// exception
}
游戏结束
当游戏结束后我们只需要更新房间的属性。其他玩家收到通知后需要根据此消息更新他们的UI。
public void updateResult(int code, String msg){
if(isConnected){
STATE = COMPLETED;
HashMap<string, object=""> properties = new HashMap<string, object="">();
properties.put("result", code);
warpClient.lockProperties(properties);
}
}
lockProperties
当两个远程玩家同玩游戏时,他们有可能会同时结束游戏,而这会引起资源竞争。这种情况最好交由服务器解决,所以我们使用了lockProperties API。所以当游戏结束时用户向服务器发送一个lockProperties请求将结果属性锁定。一旦这个结果被某个用户锁定,服务器会放弃处理后续对同一个属性的lockProperties请求。点击此处以了解更多此AppWarp仲裁方式。
随着游戏的结束,其他用户得到通知,StartMultiplayerScreen.java根据以下代码将游戏结束的原因显示到界面上。
public void onGameFinished (int code) {
if(code==WarpController.GAME_WIN){
this.msg = game_loose;
}else if(code==WarpController.GAME_LOOSE){
this.msg = game_win;
}else if(code==WarpController.ENEMY_LEFT){
this.msg = enemy_left;
}
update();
game.setScreen(this);
}
我们也要离开并取消订阅此房间,并且取消监听器;如果游戏不在运行状态我们也要删除房间。由于在这个游戏中我们使用的是AppWarp 动态房间,在使用完后最好立即删除(尽管空动态房间在60分钟后都会被自动删除)。
public void handleLeave(){
if(isConnected){
warpClient.unsubscribeRoom(roomId);
warpClient.leaveRoom(roomId);
if(STATE!=STARTED){
warpClient.deleteRoom(roomId);
}
warpClient.disconnect();
}
}
private void disconnect(){
warpClient.removeConnectionRequestListener(new ConnectionListener(this));
warpClient.removeChatRequestListener(new ChatListener(this));
warpClient.removeZoneRequestListener(new ZoneListener(this));
warpClient.removeRoomRequestListener(new RoomListener(this));
warpClient.removeNotificationListener(new NotificationListener(this));
warpClient.disconnect();
}
用户可以在这里点击并返回MainMenuScreen,然后我们可以重新进行这个过程。但这次我们只需要找到一个房间就可以开始了(因为我们已经连接到了服务器)。
总结
这篇文章中我们看到如何用AppWarp开发多人游戏。 我们在一个现成的libgdx超级跳跃例子基础上用 AppWarp Cloud 特性进行拓展。我们同样看到客户端怎样连接到AppWarp上,怎样加入游戏房间。继承概念不受libgdx的影响,并且可以应有与其他任何Java程序中。
使用Robovm发布到iOS
你可以使用 Robovm 来将超级跳跃游戏发布到iOS上. 下面是几步是任何其它项目中都需要做的。另外你需要做如下改变。
- 将这些属性添加到 robovm.xml
<forcelinkclasses>
<pattern>org.apache.harmony.xnet.provider.jsse.OpenSSLProvider</pattern>
<pattern>org.apache.harmony.security.provider.cert.DRLCertFactory</pattern>
<pattern>com.android.org.bouncycastle.jce.provider.BouncyCastleProvider</pattern>
<pattern>org.apache.harmony.security.provider.crypto.CryptoProvider</pattern>
<pattern>org.apache.harmony.xnet.provider.jsse.JSSEProvider</pattern>
<pattern>com.android.org.bouncycastle.jce.provider.JCEMac$SHA1</pattern>
</forcelinkclasses>
- 使用如下代码从背景中改变屏幕。
Gdx.app.postRunnable(new Runnable() { @Override public void run () { game.setScreen(new MultiplayerGameScreen(game, StartMultiplayerScreen.this)); } });
这里另有要求, 我们得到如下错误,因为AppWarp的回调不在UI线程中。
Exception in thread "MessageDispatchThread" java.lang.IllegalArgumentException: Error compiling shader
3. 超级跳跃中声音不可用了,这是因为iOS中的声音是使用RoboVm。