با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
gpg:: AndroidInitialization
#include <android_initialization.h>
AndroidInitialization شامل سه تابع مقداردهی اولیه است که دقیقاً یکی از آنها باید فراخوانی شود.
خلاصه
در مورد یک فعالیت استاندارد جاوا، باید از JNI_OnLoad استفاده شود. در مورد NativeActivity که JNI_OnLoad فراخوانی نمی شود، باید از android_main یا ANativeActivity_onCreate استفاده شود. android_main هنگام ساخت NativeActivity با استفاده از android_native_app_glue.h استفاده می شود. ANativeActivity_onCreate هنگام ساختن NativeActivity فقط با استفاده از native_activity.h استفاده می شود. android_native_app_glue.h و native_activity.h سرصفحه های پیش فرض اندروید هستند.
قبل از فراخوانی هر روش نمونه AndroidPlatformConfiguration، تابع اولیه مناسب باید دقیقاً یک بار فراخوانی شود، و باید قبل از نمونه سازی یک شی GameServices فراخوانی شود. نمونه سازی AndroidPlatformConfiguration قبل از یکی از فراخوانی های اولیه مجاز است (به عنوان مثال، اگر شی پیکربندی دارای دامنه جهانی باشد)، تا زمانی که هیچ روشی قبل از فراخوانی اولیه فراخوانی نشود. این متدها باید فقط یک بار در طول عمر برنامه فراخوانی شوند، نه یک بار در هر شی GameServices ایجاد شده.
توابع استاتیک عمومی |
---|
ANativeActivity_onCreate (ANativeActivity *native_activity, void *savedState, size_t savedStateSize) | void هنگام استفاده از خدمات بازی Play با NativeActivity که فقط مبتنی بر native_activity.h است، ANativeActivity_onCreate باید در طول ANativeActivity_onCreate فعالیت شما، قبل از هر تماس دیگری از خدمات بازی Play فراخوانی شود. |
JNI_OnLoad (JavaVM *jvm) | void هنگام استفاده از خدمات بازی بازی با یک فعالیت استاندارد جاوا، JNI_OnLoad باید زمانی که JNI_OnLoad کتابخانه پویا فراخوانی می شود، فراخوانی شود. |
android_main (struct android_app *app) | void هنگام استفاده از سرویسهای بازی Play با NativeActivity که مبتنی بر android_native_app_glue.h است، android_main باید در طول فعالیت android_main، قبل از هر تماس دیگری با خدمات بازی Play فراخوانی شود. |
توابع استاتیک عمومی
ANativeActivity_onCreate
void gpg::AndroidInitialization::ANativeActivity_onCreate(
ANativeActivity *native_activity,
void *savedState,
size_t savedStateSize
)
هنگام استفاده از خدمات بازی Play با NativeActivity که فقط مبتنی بر native_activity.h است، ANativeActivity_onCreate باید در طول ANativeActivity_onCreate فعالیت شما، قبل از هر تماس دیگری از خدمات بازی Play فراخوانی شود.
JNI_OnLoad
void gpg::AndroidInitialization::JNI_OnLoad(
JavaVM *jvm
)
هنگام استفاده از خدمات بازی بازی با یک فعالیت استاندارد جاوا، JNI_OnLoad باید زمانی که JNI_OnLoad کتابخانه پویا فراخوانی می شود، فراخوانی شود.
android_main
void gpg::AndroidInitialization::android_main(
struct android_app *app
)
هنگام استفاده از سرویسهای بازی Play با NativeActivity که مبتنی بر android_native_app_glue.h است، android_main باید در طول فعالیت android_main، قبل از هر تماس دیگری با خدمات بازی Play فراخوانی شود.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# gpg::AndroidInitialization Struct Reference\n\ngpg::AndroidInitialization\n==========================\n\n`#include \u003candroid_initialization.h\u003e`\n\n[AndroidInitialization](/games/services/cpp/api/struct/gpg/android-initialization#structgpg_1_1_android_initialization) includes three initialization functions, exactly one of which must be called.\n\nSummary\n-------\n\nIn the case of a standard Java Activity, JNI_OnLoad should be used. In the case of a NativeActivity where JNI_OnLoad will not be called, either android_main or ANativeActivity_onCreate should be used. android_main is used when building a NativeActivity using android_native_app_glue.h. ANativeActivity_onCreate is used when building a NativeActivity using just native_activity.h. android_native_app_glue.h and native_activity.h are default Android headers.\n\nThe appropriate initialization function must be called exactly once before any [AndroidPlatformConfiguration](/games/services/cpp/api/class/gpg/android-platform-configuration#classgpg_1_1_android_platform_configuration) instance methods are called, and it must be called before a [GameServices](/games/services/cpp/api/class/gpg/game-services#classgpg_1_1_game_services) object is instantiated. It is permitted to instantiate a [AndroidPlatformConfiguration](/games/services/cpp/api/class/gpg/android-platform-configuration#classgpg_1_1_android_platform_configuration) before one of the initialization calls (for example, if the configuration object has global scope), as long as no methods are called before the initialization call. These methods need be called only once in the lifetime of the calling program, not once per [GameServices](/games/services/cpp/api/class/gpg/game-services#classgpg_1_1_game_services) object created.\n\n| ### Public static functions ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [ANativeActivity_onCreate](#structgpg_1_1_android_initialization_1a816753e9576f07d1d58f2e94b26ad66c)`(ANativeActivity *native_activity, void *savedState, size_t savedStateSize)` | `void` When using Play Game Services with a NativeActivity which is based on only native_activity.h, ANativeActivity_onCreate should be called during your activity's ANativeActivity_onCreate, before any other Play Game Services calls. |\n| [JNI_OnLoad](#structgpg_1_1_android_initialization_1ae43182cd58941ddc74eb07535c8de97a)`(JavaVM *jvm)` | `void` When using Play Game Services with a standard Java Activity, JNI_OnLoad should be called when the dynamic library's JNI_OnLoad is called. |\n| [android_main](#structgpg_1_1_android_initialization_1ace2b90a82cc0b9ad5aeb7ac73996b100)`(struct android_app *app)` | `void` When using Play Game Services with a NativeActivity which is based on android_native_app_glue.h, android_main should be called during your activity's android_main, before any other Play Game Services calls. |\n\nPublic static functions\n-----------------------\n\n### ANativeActivity_onCreate\n\n```c++\nvoid gpg::AndroidInitialization::ANativeActivity_onCreate(\n ANativeActivity *native_activity,\n void *savedState,\n size_t savedStateSize\n)\n``` \nWhen using Play Game Services with a NativeActivity which is based on only native_activity.h, ANativeActivity_onCreate should be called during your activity's ANativeActivity_onCreate, before any other Play Game Services calls. \n\n### JNI_OnLoad\n\n```c++\nvoid gpg::AndroidInitialization::JNI_OnLoad(\n JavaVM *jvm\n)\n``` \nWhen using Play Game Services with a standard Java Activity, JNI_OnLoad should be called when the dynamic library's JNI_OnLoad is called. \n\n### android_main\n\n```c++\nvoid gpg::AndroidInitialization::android_main(\n struct android_app *app\n)\n``` \nWhen using Play Game Services with a NativeActivity which is based on android_native_app_glue.h, android_main should be called during your activity's android_main, before any other Play Game Services calls."]]