com.jme3.app

Class AndroidHarness

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.view.ContextThemeWrapper

android.app.Activity

com.jme3.app.AndroidHarness

All Implemented Interfaces:

android.content.ComponentCallbacks, android.content.ComponentCallbacks2, android.content.DialogInterface.OnClickListener, android.view.KeyEvent.Callback, android.view.LayoutInflater.Factory, android.view.LayoutInflater.Factory2, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback, com.jme3.input.controls.InputListener, com.jme3.input.controls.TouchListener, com.jme3.system.SystemListener

public class AndroidHarness
extends android.app.Activity
implements com.jme3.input.controls.TouchListener, android.content.DialogInterface.OnClickListener, com.jme3.system.SystemListener

AndroidHarness wraps a jme application object and runs it on Android

Author:

Kirill, larynx

Field Summary

Fields

Modifier and Type	Field and Description
protected com.jme3.app.LegacyApplication	app The jme3 application object
protected java.lang.String	appClass The application class to start
protected java.lang.String	audioRendererType Sets the type of Audio Renderer to be used.
protected OGLESContext	ctx
protected int	eglAlphaBits Sets the desired number of Alpha bits for the surfaceview.
protected int	eglBitsPerPixel Sets the desired RGB size for the surfaceview.
protected int	eglDepthBits The number of depth bits specifies the precision of the depth buffer.
protected int	eglSamples Sets the number of samples to use for multisampling. Leave 0 (default) to disable multisampling. Set to 2 or 4 to enable multisampling.
protected int	eglStencilBits Set the number of stencil bits.
protected java.lang.String	exitDialogMessage Message of the exit dialog, default is "Use your home key to bring this app into the background or exit to terminate it."
protected java.lang.String	exitDialogTitle Title of the exit dialog, default is "Do you want to exit?"
protected boolean	finishOnAppStop if true finish this activity when the jme app is stopped
protected android.widget.FrameLayout	frameLayout
protected int	frameRate Set the desired frame rate.
protected boolean	handleExitHook set to false if you don't want the harness to handle the exit hook
protected boolean	isGLThreadPaused
protected boolean	joystickEventsEnabled If true Android Sensors are used as simulated Joysticks.
protected boolean	keyEventsEnabled If true KeyEvents are generated from TouchEvents
protected static java.util.logging.Logger	logger
protected boolean	mouseEventsEnabled If true MouseEvents are generated from TouchEvents
protected boolean	mouseEventsInvertX Flip X axis
protected boolean	mouseEventsInvertY Flip Y axis
protected boolean	screenFullScreen Set the screen window mode.
protected boolean	screenShowTitle if screenShowTitle is true while screenFullScreen is false, then the title bar is also displayed under the notification bar
protected android.widget.ImageView	splashImageView
protected int	splashPicID Splash Screen picture Resource ID.
protected android.opengl.GLSurfaceView	view

Fields inherited from class android.app.Activity

DEFAULT_KEYS_DIALER, DEFAULT_KEYS_DISABLE, DEFAULT_KEYS_SEARCH_GLOBAL, DEFAULT_KEYS_SEARCH_LOCAL, DEFAULT_KEYS_SHORTCUT, FOCUSED_STATE_SET, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, APP_OPS_SERVICE, AUDIO_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, BLUETOOTH_SERVICE, CAPTIONING_SERVICE, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONSUMER_IR_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DISPLAY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, KEYGUARD_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_ROUTER_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, PRINT_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, STORAGE_SERVICE, TELEPHONY_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, UI_MODE_SERVICE, USB_SERVICE, USER_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_P2P_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Fields inherited from interface android.content.ComponentCallbacks2

TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Constructor Summary

Constructors

Constructor and Description
AndroidHarness()

Method Summary

Modifier and Type	Method and Description
void	destroy()
void	gainFocus()
com.jme3.app.Application	getJmeApplication()
void	handleError(java.lang.String errorMsg, java.lang.Throwable t) Called when an error has occurred.
void	initialize()
protected void	initializeLogHandler() Removes the standard Android log handler due to an issue with not logging entries lower than INFO level and adds a handler that produces JME formatted log messages.
void	layoutDisplay()
void	loseFocus()
void	onClick(android.content.DialogInterface dialog, int whichButton) Called by the android alert dialog, terminate the activity and OpenGL rendering
void	onCreate(android.os.Bundle savedInstanceState)
protected void	onDestroy()
protected void	onPause()
protected void	onRestart()
protected void	onResume()
java.lang.Object	onRetainNonConfigurationInstance()
protected void	onStart()
protected void	onStop()
void	onTouch(java.lang.String name, com.jme3.input.event.TouchEvent evt, float tpf) Gets called by the InputManager on all touch/drag/scale events
void	removeSplashScreen()
void	requestClose(boolean esc)
void	reshape(int width, int height)
void	update()

Methods inherited from class android.app.Activity

addContentView, closeContextMenu, closeOptionsMenu, createPendingResult, dismissDialog, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, dump, findViewById, finish, finishActivity, finishActivityFromChild, finishAffinity, finishFromChild, getActionBar, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getCurrentFocus, getFragmentManager, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLoaderManager, getLocalClassName, getMenuInflater, getParent, getParentActivityIntent, getPreferences, getRequestedOrientation, getSystemService, getTaskId, getTitle, getTitleColor, getVolumeControlStream, getWindow, getWindowManager, hasWindowFocus, invalidateOptionsMenu, isChangingConfigurations, isChild, isDestroyed, isFinishing, isImmersive, isTaskRoot, managedQuery, moveTaskToBack, navigateUpTo, navigateUpToFromChild, onActionModeFinished, onActionModeStarted, onActivityResult, onApplyThemeResource, onAttachedToWindow, onAttachFragment, onBackPressed, onChildTitleChanged, onConfigurationChanged, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreateContextMenu, onCreateDescription, onCreateDialog, onCreateDialog, onCreateNavigateUpTaskStack, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onCreateView, onCreateView, onDetachedFromWindow, onGenericMotionEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyShortcut, onKeyUp, onLowMemory, onMenuItemSelected, onMenuOpened, onNavigateUp, onNavigateUpFromChild, onNewIntent, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPostCreate, onPostResume, onPrepareDialog, onPrepareDialog, onPrepareNavigateUpTaskStack, onPrepareOptionsMenu, onPreparePanel, onProvideAssistData, onRestoreInstanceState, onSaveInstanceState, onSearchRequested, onTitleChanged, onTouchEvent, onTrackballEvent, onTrimMemory, onUserInteraction, onUserLeaveHint, onWindowAttributesChanged, onWindowFocusChanged, onWindowStartingActionMode, openContextMenu, openOptionsMenu, overridePendingTransition, recreate, registerForContextMenu, removeDialog, reportFullyDrawn, requestWindowFeature, runOnUiThread, setContentView, setContentView, setContentView, setDefaultKeyMode, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setFinishOnTouchOutside, setImmersive, setIntent, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTitle, setTitle, setTitleColor, setVisible, setVolumeControlStream, shouldUpRecreateTask, showDialog, showDialog, startActionMode, startActivities, startActivities, startActivity, startActivity, startActivityForResult, startActivityForResult, startActivityFromChild, startActivityFromChild, startActivityFromFragment, startActivityFromFragment, startActivityIfNeeded, startActivityIfNeeded, startIntentSender, startIntentSender, startIntentSenderForResult, startIntentSenderForResult, startIntentSenderFromChild, startIntentSenderFromChild, startManagingCursor, startNextMatchingActivity, startNextMatchingActivity, startSearch, stopManagingCursor, takeKeyEvents, triggerSearch, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper

applyOverrideConfiguration, attachBaseContext, getResources, getTheme, setTheme

Methods inherited from class android.content.ContextWrapper

bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createConfigurationContext, createDisplayContext, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getContentResolver, getDatabasePath, getDir, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getFilesDir, getFileStreamPath, getMainLooper, getObbDir, getObbDirs, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getSharedPreferences, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isRestricted, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, removeStickyBroadcastAsUser, revokeUriPermission, sendBroadcast, sendBroadcast, sendBroadcastAsUser, sendBroadcastAsUser, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcastAsUser, sendStickyBroadcast, sendStickyBroadcastAsUser, sendStickyOrderedBroadcast, sendStickyOrderedBroadcastAsUser, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getString, getString, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, registerComponentCallbacks, unregisterComponentCallbacks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logger

protected static final java.util.logging.Logger logger

appClass

protected java.lang.String appClass

The application class to start

app

protected com.jme3.app.LegacyApplication app

The jme3 application object

eglBitsPerPixel

protected int eglBitsPerPixel

Sets the desired RGB size for the surfaceview. 16 = RGB565, 24 = RGB888. (default = 24)

eglAlphaBits

protected int eglAlphaBits

Sets the desired number of Alpha bits for the surfaceview. This affects how the surfaceview is able to display Android views that are located under the surfaceview jME uses to render the scenegraph. 0 = Opaque surfaceview background (fastest) 1->7 = Transparent surfaceview background 8 or higher = Translucent surfaceview background (default = 0)

eglDepthBits

protected int eglDepthBits

The number of depth bits specifies the precision of the depth buffer. (default = 16)

eglSamples

protected int eglSamples

Sets the number of samples to use for multisampling.
Leave 0 (default) to disable multisampling.
Set to 2 or 4 to enable multisampling.

eglStencilBits

protected int eglStencilBits

Set the number of stencil bits. (default = 0)

frameRate

protected int frameRate

Set the desired frame rate. If frameRate higher than 0, the application will be capped at the desired frame rate. (default = -1, no frame rate cap)

audioRendererType

protected java.lang.String audioRendererType

Sets the type of Audio Renderer to be used.

Android MediaPlayer / SoundPool can be used on all supported Android platform versions (2.2+)
OpenAL Soft uses an OpenSL backend and is only supported on Android versions 2.3+.

Only use ANDROID_ static strings found in AppSettings

joystickEventsEnabled

protected boolean joystickEventsEnabled

If true Android Sensors are used as simulated Joysticks. Users can use the Android sensor feedback through the RawInputListener or by registering JoyAxisTriggers.

keyEventsEnabled

protected boolean keyEventsEnabled

If true KeyEvents are generated from TouchEvents

mouseEventsEnabled

protected boolean mouseEventsEnabled

If true MouseEvents are generated from TouchEvents

mouseEventsInvertX

protected boolean mouseEventsInvertX

Flip X axis

mouseEventsInvertY

protected boolean mouseEventsInvertY

Flip Y axis

finishOnAppStop

protected boolean finishOnAppStop

if true finish this activity when the jme app is stopped

handleExitHook

protected boolean handleExitHook

set to false if you don't want the harness to handle the exit hook

exitDialogTitle

protected java.lang.String exitDialogTitle

Title of the exit dialog, default is "Do you want to exit?"

exitDialogMessage

protected java.lang.String exitDialogMessage

Message of the exit dialog, default is "Use your home key to bring this app into the background or exit to terminate it."

screenFullScreen

protected boolean screenFullScreen

Set the screen window mode. If screenFullSize is true, then the notification bar and title bar are removed and the screen covers the entire display. If screenFullSize is false, then the notification bar remains visible if screenShowTitle is true while screenFullScreen is false, then the title bar is also displayed under the notification bar.

screenShowTitle

protected boolean screenShowTitle

if screenShowTitle is true while screenFullScreen is false, then the title bar is also displayed under the notification bar

splashPicID

protected int splashPicID

Splash Screen picture Resource ID. If a Splash Screen is desired, set splashPicID to the value of the Resource ID (i.e. R.drawable.picname). If splashPicID = 0, then no splash screen will be displayed.

ctx

protected OGLESContext ctx

view

protected android.opengl.GLSurfaceView view

isGLThreadPaused

protected boolean isGLThreadPaused

splashImageView

protected android.widget.ImageView splashImageView

frameLayout

protected android.widget.FrameLayout frameLayout

Constructor Detail

AndroidHarness

public AndroidHarness()

Method Detail

onRetainNonConfigurationInstance

public java.lang.Object onRetainNonConfigurationInstance()

Overrides:

onRetainNonConfigurationInstance in class android.app.Activity

onCreate

public void onCreate(android.os.Bundle savedInstanceState)

Overrides:

onCreate in class android.app.Activity

onRestart

protected void onRestart()

Overrides:

onRestart in class android.app.Activity

onStart

protected void onStart()

Overrides:

onStart in class android.app.Activity

onResume

protected void onResume()

Overrides:

onResume in class android.app.Activity

onPause

protected void onPause()

Overrides:

onPause in class android.app.Activity

onStop

protected void onStop()

Overrides:

onStop in class android.app.Activity

onDestroy

protected void onDestroy()

Overrides:

onDestroy in class android.app.Activity

getJmeApplication

public com.jme3.app.Application getJmeApplication()

handleError

public void handleError(java.lang.String errorMsg,
                        java.lang.Throwable t)

Called when an error has occurred. By default, will show an error message to the user and print the exception/error to the log.

Specified by:

handleError in interface com.jme3.system.SystemListener

onClick

public void onClick(android.content.DialogInterface dialog,
                    int whichButton)

Called by the android alert dialog, terminate the activity and OpenGL rendering

Specified by:

onClick in interface android.content.DialogInterface.OnClickListener

Parameters:

dialog -

whichButton -

onTouch

public void onTouch(java.lang.String name,
                    com.jme3.input.event.TouchEvent evt,
                    float tpf)

Gets called by the InputManager on all touch/drag/scale events

Specified by:

onTouch in interface com.jme3.input.controls.TouchListener

layoutDisplay

public void layoutDisplay()

removeSplashScreen

public void removeSplashScreen()

initializeLogHandler

protected void initializeLogHandler()

Removes the standard Android log handler due to an issue with not logging entries lower than INFO level and adds a handler that produces JME formatted log messages.

initialize

public void initialize()

Specified by:

initialize in interface com.jme3.system.SystemListener

reshape

public void reshape(int width,
                    int height)

Specified by:

reshape in interface com.jme3.system.SystemListener

update

public void update()

Specified by:

update in interface com.jme3.system.SystemListener

requestClose

public void requestClose(boolean esc)

Specified by:

requestClose in interface com.jme3.system.SystemListener

destroy

public void destroy()

Specified by:

destroy in interface com.jme3.system.SystemListener

gainFocus

public void gainFocus()

Specified by:

gainFocus in interface com.jme3.system.SystemListener

loseFocus

public void loseFocus()

Specified by:

loseFocus in interface com.jme3.system.SystemListener