第五章（2）Libgdx应用框架之启动类和配置

 

   对于每个目标平台而言（本章只讲述Android），启动类必须实现。这个类实现一个后端特定的应用接口，ApplicationListener实现应用逻辑。启动类对平台有一定的依赖性，接下来我们看看怎样实例化和配置android的后端。

  本章假设你已经根据第四章（1）的内容配置好android项目。

 Android应用不使用main（）方法作为入口，而是通过一个Activity。打开my-gdx-game-android项目中的MainActivity.java类：

package com.me.mygdxgame;

import android.os.Bundle;

importcom.badlogic.gdx.backends.android.AndroidApplication;

importcom.badlogic.gdx.backends.android.AndroidApplicationConfiguration;

public class MainActivity extendsAndroidApplication {

   @Override

   public void onCreate(Bundle savedInstanceState) {

       super.onCreate(savedInstanceState);        

       AndroidApplicationConfiguration cfg = newAndroidApplicationConfiguration();

       cfg.useGL20 = false;        

       initialize(new MyGdxGame(), cfg);

    }

}

 

 

主入口方法是Activity的OnCreate（）方法。注意MainActivity继承自AndroidApplication，AndroidApplication继承自Activity。一旦配置好，AndroidApplication.initialize()就会被调用，传递到ApplicationListener（MyGdxGame）。

Android可以有多个Activity。Libgdx游戏通常只有一个Activity组成。游戏的不同的屏幕在libgdx中实现，而不是分成多个Activity。这样做的原因是创建一个新的Activity同样需要创建一个新的OpenGL 环境，也就意味着所有的图像资源被重新加载。

AndroidManifest.xml文件

除了AndroidApplicationConfiguration，Android应用也通过AndroidManifest.xml进行配置，可以在Android项目的根目录下找到这个文件：

<?xml version="1.0"encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

   package="com.me.mygdxgame"

   android:versionCode="1"

   android:versionName="1.0" >

 

   <uses-sdk android:minSdkVersion="5"android:targetSdkVersion="17" />

 

   <application

       android:icon="@drawable/ic_launcher"

       android:label="@string/app_name" >

       <activity

           android:name=".MainActivity"

           android:label="@string/app_name"

           android:screenOrientation="landscape"

           android:configChanges="keyboard|keyboardHidden|orientation|screenSize">

           <intent-filter>

                <actionandroid:name="android.intent.action.MAIN" />

                <categoryandroid:name="android.intent.category.LAUNCHER" />

           </intent-filter>

       </activity>

   </application>

 

</manifest>

 

 

目标SDk版本

这是至关重要的，如果希望自己的应用运行在Android1.5以上的版本targetSdkVersion的值最小为6.如果这个值没有设置，应用将运行在传统模式。实际绘图区将小于屏幕实际分辨率，很难看。

屏幕方向和配置更改

除了targetSdkVersion，screenOrientation和 configChanges属性也需要也需要设置。

screenOrientation属性指明应用的方向。一旦省略这个属性，应用将可以同时在横屏或竖屏中运行。

configChanges属性至关重要，省略这个属性意味着每次键盘点击或方向变化时，应用将重新启动。如果省略screenOrientation，一个libgdx将获得一个ApplicationListener.resize()指示方向变化。可以根据情况布局你的应用。

权限

如果应用需要写入SD卡，需要上网，需要保持屏幕唤醒或者记录音频等，必须在AndroidManifest.xml中添加以下权限：

<uses-permission android:name="android.permission.RECORD_AUDIO"/>

       <uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

       <uses-permissionandroid:name="android.permission.VIBRATE"/>

       <uses-permission android:name="android.permission.WAKE_LOCK"/>  

 

 

用户经常怀疑这些权限的用处，所以要明智的进行选择。

对于工作后锁定，设置相应的AndroidApplicationConfiguration.useWakeLock为true。

如果一个游戏不需要加速度计和罗盘访问，通过设置AndroidApplicationConfiguration 中的useAccelerometer和useCompass设置为false。

LiveWallpapers

Libgdx可以通过较为简单的方式创建基于Android的LiveWallpapers。一个livewallpaper的启动类称为AndroidLiveWallpaperService，以下是示例：

package com.mypackage;

 

// imports snipped for brevity 

 

public class LiveWallpaper extendsAndroidLiveWallpaperService {

       @Override

       public ApplicationListener createListener () {

                return newMyApplicationListener();

       }

 

       @Override

       public AndroidApplicationConfiguration createConfig () {

                return newAndroidApplicationConfiguration();

       }

 

       @Override

       public void offsetChange (ApplicationListener listener, float xOffset,float yOffset, float xOffsetStep, float yOffsetStep,

                int xPixelOffset, intyPixelOffset) {

               Gdx.app.log("LiveWallpaper", "offset changed: " +xOffset + ", " + yOffset);

       }

}

 

 

createListener() 和createConfig()方法将在livepaper在主屏幕上创建时调用。

offsetChange()方法将被渲染线程调用，所以你不需要更改。

除了启动类，你也需要创建一个XML文件描述你的Wallpaper。我们可以定义它的名字为livewallpaper.xml。在你的res文件夹下创建一个xml文件夹，将文件放入其中。

<?xml version="1.0"encoding="UTF-8"?>

<wallpaper

      xmlns:android="http://schemas.android.com/apk/res/android"  

      android:thumbnail="@drawable/ic_launcher"

      android:description="@string/description"

      android:settingsActivity="com.mypackage.LivewallpaperSettings"/>

 

 

这里定义一个thumbnail显示你的LWP中，当用户点击LWP中Setting时将显示一个Activity或者描述。通过Activity改变背景颜色，你也可以存储到SharedPreferences，将它们之后通过Gdx.app.getPreferences()载入到LWP中。

最后，你需要添加一些东西到AndroidManifest.xml中，以下是一个简单的示例：

<?xml version="1.0"encoding="utf-8"?>

<manifestxmlns:android="http://schemas.android.com/apk/res/android"

     package="com.mypackage"

     android:versionCode="1"

     android:versionName="1.0"

     android:installLocation="preferExternal">

       <uses-sdk android:minSdkVersion="7" android:targetSdkVersion="14"/>     

       <uses-featureandroid:name="android.software.live_wallpaper" />

                

       <application android:icon="@drawable/icon"android:label="@string/app_name">

                <activityandroid:name=".LivewallpaperSettings" 

                                 android:label="Livewallpaper Settings"/>

                

                <serviceandroid:name=".LiveWallpaper"

           android:label="@string/app_name"

           android:icon="@drawable/icon"

           android:permission="android.permission.BIND_WALLPAPER">

           <intent-filter>

                <actionandroid:name="android.service.wallpaper.WallpaperService" />

           </intent-filter>

           <meta-data android:name="android.service.wallpaper"

               android:resource="@xml/livewallpaper" />

       </service>                                      

       </application>

</manifest>

 

 

Daydream

从Android4.2开始，用户可以设置Daydreams，会在设备闲置或停靠时显示。这些daydream类似屏保或者显示相册之类的东西。Libgdx可以让你轻松的编写Daydream.

Daydream的启动类为AndroidDaydream，以下是示例：

packagecom.badlogic.gdx.tests.android;

 

importandroid.annotation.TargetApi;

importandroid.util.Log;

 

importcom.badlogic.gdx.ApplicationListener;

importcom.badlogic.gdx.backends.android.AndroidApplicationConfiguration;

importcom.badlogic.gdx.backends.android.AndroidDaydream;

importcom.badlogic.gdx.tests.MeshShaderTest;

 

@TargetApi(17)

publicclass Daydream extends AndroidDaydream {

   @Override

   public void onAttachedToWindow(){

      super.onAttachedToWindow();      

          setInteractive(false);

 

      AndroidApplicationConfiguration cfg = newAndroidApplicationConfiguration();

      cfg.useGL20 = true;

      ApplicationListener app = newMeshShaderTest();

      initialize(app, cfg);

   }

}

 

 

简单的继承了AndroidDaydream，重写了onAttachedToWindow，设置你的配置和ApplicationListener并初始化你的daydream。

处理daydream本身你可以提供一个Activity来设置daydream。这可以是一个普通的Activity，或者一个libgdx的AndroidApplication（继承自Activity）。一个空的Activity作为例子：

 

packagecom.badlogic.gdx.tests.android;

 

importandroid.app.Activity;

 

publicclass DaydreamSettings extends Activity {

 

}

 

 

这个Activity必须指明到daydream服务的元数据。在res/xml下创建xml文件，如下：

<dreamxmlns:android="http://schemas.android.com/apk/res/android"

 android:settingsActivity="com.badlogic.gdx.tests.android/.DaydreamSettings"/>

 

 

最后，在AndroidManifest.xml中添加Activity的信息，一个daydream的服务描述。如下：

<serviceandroid:name=".Daydream"

   android:label="@string/app_name"

   android:icon="@drawable/icon"

   android:exported="true">

   <intent-filter>

           <action android:name="android.service.dreams.DreamService"/>

           <categoryandroid:name="android.intent.category.DEFAULT" />

   </intent-filter>

   <meta-dataandroid:name="android.service.dream"

          android:resource="@xml/daydream" />

</service>