FlixelAndroidHostIntegration

View source

class

org.flixelgdx.backend.android.FlixelAndroidHostIntegration

public class FlixelAndroidHostIntegration implements FlixelHostIntegration

Android FlixelHostIntegration: system notifications via NotificationManager, screen wake lock via FLAG_KEEP_SCREEN_ON, back-button exit confirmation via an InputMultiplexer, and text clipboard access via ClipboardManager.

Installed automatically by FlixelAndroidLauncher; game code should not need to instantiate this directly.

Notification permission

Android 13 (API 33) and above require the POST_NOTIFICATIONS runtime permission before notifications are displayed. Call FlixelAndroidHostIntegration.requestNotificationPermission() early in your game, ideally during a loading screen or in response to a user gesture, and confirm FlixelAndroidHostIntegration.supportsNotifications() returns true before calling FlixelAndroidHostIntegration.sendNotification(String, String).

You must also declare the permission in your AndroidManifest.xml:

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

Exit confirmation

When a message is set via FlixelAndroidHostIntegration.setExitConfirmation(String), the hardware or gesture back action is caught by an InputMultiplexer inserted in front of any existing InputProcessor. Pressing back shows an AlertDialog with the message and an "Exit" button that calls Gdx.app.exit(). Passing null removes the guard and restores the previous processor.

Methods

requestNotificationPermission()

public void requestNotificationPermission()

---

requestAttention()

public void requestAttention()

---

keepScreenAwake(boolean)

public void keepScreenAwake(boolean awake)

---

setExitConfirmation(String)

public void setExitConfirmation(String message)

---

sendNotification(String, String)

public void sendNotification(String title, String message)

---

copyToClipboard(String)

public void copyToClipboard(String text)

---

pasteFromClipboard()

public void pasteFromClipboard()

---

supportsNotifications()

public boolean supportsNotifications()

---

supportsWakeLock()

public boolean supportsWakeLock()

---

supportsClipboard()

public boolean supportsClipboard()

---

onTextPasted()

public FlixelSignal<String> onTextPasted()

---