gpg::AndroidInitialization

#include <android_initialization.h>

AndroidInitialization 包含三個初始化函式,也就是必須呼叫其中一個函式。

摘要

如果是標準 Java 活動,則應使用 JNI_OnLoad。如果是無法呼叫 JNI_OnLoad 的 NativeActivity,則應使用 android_main 或 ANativeActivity_onCreate。當使用 android_native_app_glue.h 建構 NativeActivity 時,系統會使用 android_main。當僅使用 native_activity.h 建構 NativeActivity 時,系統會使用 ANativeActivity_onCreate。android_native_app_glue.h 和 native_activity.h 是預設的 Android 標頭。

呼叫任何 AndroidPlatformConfiguration 執行個體方法之前,就必須只呼叫一次適當的初始化函式,而且必須在 GameServices 物件執行個體化之前呼叫該函式。系統允許在其中一個初始化呼叫之前將 AndroidPlatformConfiguration 執行個體化 (例如設定物件包含全域範圍),前提是初始化呼叫前沒有呼叫任何方法。這些方法在呼叫程式的生命週期中只須呼叫一次,而非在每個 GameServices 物件中呼叫一次。

公開的靜態函式

ANativeActivity_onCreate(ANativeActivity *native_activity, void *savedState, size_t savedStateSize)
void
將 Play 遊戲服務與僅以 native_activity.h 為基礎的 NativeActivity 時,應在活動的 ANativeActivity_onCreate 執行期間呼叫 ANativeActivity_onCreate,然後才呼叫任何其他 Play 遊戲服務呼叫。
JNI_OnLoad(JavaVM *jvm)
void
將 Play 遊戲服務與標準 Java 活動搭配使用時,應在呼叫動態程式庫的 JNI_OnLoad 時呼叫 JNI_OnLoad。
android_main(struct android_app *app)
void
將 Play 遊戲服務與以 android_native_app_glue.h 為基礎的 NativeActivity 搭配使用時,應在活動的 android_main 期間呼叫 android_main,然後再呼叫任何其他 Play 遊戲服務呼叫。

公開的靜態函式

ANativeActivity_onCreate

void gpg::AndroidInitialization::ANativeActivity_onCreate(
  ANativeActivity *native_activity,
  void *savedState,
  size_t savedStateSize
)

將 Play 遊戲服務與僅以 native_activity.h 為基礎的 NativeActivity 時,應在活動的 ANativeActivity_onCreate 執行期間呼叫 ANativeActivity_onCreate,然後才呼叫任何其他 Play 遊戲服務呼叫。

JNI_OnLoad

void gpg::AndroidInitialization::JNI_OnLoad(
  JavaVM *jvm
)

將 Play 遊戲服務與標準 Java 活動搭配使用時,應在呼叫動態程式庫的 JNI_OnLoad 時呼叫 JNI_OnLoad。

android_main

void gpg::AndroidInitialization::android_main(
  struct android_app *app
)

將 Play 遊戲服務與以 android_native_app_glue.h 為基礎的 NativeActivity 搭配使用時,應在活動的 android_main 期間呼叫 android_main,然後再呼叫任何其他 Play 遊戲服務呼叫。