gpg::AndroidSupport

#include <android_support.h>

ऐसे फ़ंक्शन जो Android 4.0 से पहले के वर्शन पर काम करने की सुविधा चालू करते हैं.

खास जानकारी

Android लाइफ़साइकल कॉलबैक

Android 2.3 या 3.x डिवाइसों (14 से पहले के एपीआई वर्शन) को टारगेट करने वाले ऐप्लिकेशन के लिए, Play की गेम सेवाओं में ऐक्टिविटी लाइफ़साइकल कॉलबैक अपने-आप पाने का कोई तरीका नहीं है. ऐसे मामलों में, Play की गेम सेवाएं, लाइफ़साइकल इवेंट की सूचना देने के लिए मालिकाना हक वाली गतिविधि का इस्तेमाल करती हैं. GameServices ऑब्जेक्ट का मालिकाना हक रखने वाली किसी भी ऐक्टिविटी को अपने लाइफ़साइकल कॉलबैक फ़ंक्शन से, AndroidSupport::* फ़ंक्शन को कॉल करना चाहिए. इन फ़ंक्शन में मौजूद आर्ग्युमेंट, Android के आर्ग्युमेंट से मेल खाते हैं. इसलिए, अलग से प्रोसेस करने की ज़रूरत नहीं है.

Android 4.0+ (एपीआई वर्शन 14 से बड़ा या इसके बराबर) को टारगेट करने वाले ऐप्लिकेशन के लिए, इनमें से ज़्यादातर फ़ंक्शन कॉल ज़रूरी नहीं होते हैं. ऐसे ऐप्लिकेशन के लिए, सिर्फ़ OnActivityresults फ़ंक्शन को कॉल किया जाना चाहिए.

Java गतिविधि का इस्तेमाल करने वाले, Android 4.0 से पहले के गेम के लिए कोड का उदाहरण

अपनी Java गतिविधि में, कृपया यह जोड़ें. आपको इस कोड को अपने मौजूदा लाइफ़साइकल फ़ंक्शन के साथ मर्ज करना पड़ सकता है.

import android.app.Activity;
import android.content.Intent;

public class YourActivity extends Activity {
  protected void onCreate(Bundle savedInstanceState){
    super.onCreate(savedInstanceState);
    nativeOnActivityCreated(this, savedInstanceState);
  }

  protected void onDestroy(){
    super.onDestroy();
    nativeOnActivityDestroyed(this);
  }

  protected void onPause(){
    super.onPause();
    nativeOnActivityPaused(this);
  }

  protected void onResume(){
    super.onResume();
    nativeOnActivityResumed(this);
  }

  protected void onStart(){
    super.onStart();
    nativeOnActivityStarted(this);
  }

  protected void onStop(){
    super.onStop();
    nativeOnActivityStopped(this);
  }

  protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    nativeOnActivitySaveInstanceState(this, outState);
  }

  protected void onActivityResult(int requestCode,
                                  int resultCode,
                                  Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    nativeOnActivityResult(this, requestCode, resultCode, data);
  }

  // Implemented in C++.
  private static native void nativeOnActivityCreated(
      Activity activity, Bundle savedInstanceState);
  private static native void nativeOnActivityDestroyed(Activity activity);
  private static native void nativeOnActivityPaused(Activity activity);
  private static native void nativeOnActivityResumed(Activity activity);
  private static native void nativeOnActivitySaveInstanceState(
      Activity activity,
      Bundle outState);
  private static native void nativeOnActivityStarted(Activity activity);
  private static native void nativeOnActivityStopped(Activity activity);
  private static native void nativeOnActivityResult(
      Activity activity,
      int requestCode,
      int resultCode,
      Intent data);
}

इसके बाद, अपनी नेटिव लाइब्रेरी में, फ़ॉरवर्ड करने वाले ये फ़ंक्शन जोड़ें.

void Java_com_example_yourapp_YourActivity_nativeOnActivityCreated(
    JNIEnv* env,
    jobject thiz,
    jobject activity,
    jobject saved_instance_state) {
  gpg::AndroidSupport::OnActivityCreated(env,
                                         activity,
                                         saved_instance_state);
}

void Java_com_example_yourapp_YourActivity_nativeOnActivityDestroyed(
    JNIEnv* env, jobject thiz, jobject activity) {
  gpg::AndroidSupport::OnActivityDestroyed(env, activity);
}

void Java_com_example_yourapp_YourActivity_nativeOnActivityPaused(
    JNIEnv* env, jobject thiz, jobject activity) {
  gpg::AndroidSupport::OnActivityPaused(env, activity);
}

void Java_com_example_yourapp_YourActivity_nativeOnActivityResumed(
    JNIEnv* env, jobject thiz, jobject activity) {
  gpg::AndroidSupport::OnActivityResumed(env, activity);
}

void Java_com_example_yourapp_YourActivity_nativeOnActivitySaveInstanceState(
    JNIEnv* env, jobject thiz, jobject activity, jobject out_state) {
  gpg::AndroidSupport::OnActivitySaveInstanceState(env, activity, out_state);
}

void Java_com_example_yourapp_YourActivity_nativeOnActivityStarted(
    JNIEnv* env, jobject thiz, jobject activity) {
  gpg::AndroidSupport::OnActivityStarted(env, activity);
}

void Java_com_example_yourapp_YourActivity_nativeOnActivityStopped(
    JNIEnv* env, jobject thiz, jobject activity) {
  gpg::AndroidSupport::OnActivityStopped(env, activity);
}

void Java_com_example_yourapp_YourActivity_nativeOnActivityResult(
    JNIEnv* env,
    jobject thiz,
    jobject activity,
    jint request_code,
    jint result_code,
    jobject data) {
  gpg::AndroidSupport::OnActivityResult(
      env, activity, request_code, result_code, data);
}

Java गतिविधि का इस्तेमाल करने वाले Android 4.0+ गेम के लिए कोड का उदाहरण

अपनी Java गतिविधि में, कृपया यह जोड़ें. आपको इस कोड को अपने मौजूदा लाइफ़साइकल फ़ंक्शन के साथ मर्ज करना पड़ सकता है.

public class YourActivity extends Activity {
  protected void onActivityResult(int requestCode,
                                  int resultCode,
                                  Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    nativeOnActivityResult(this, requestCode, resultCode, data);
  }

  // Implemented in C++.
  private static native void nativeOnActivityResult(
      Activity activity,
      int requestCode,
      int resultCode,
      Intent data);
}

इसके बाद, अपनी नेटिव लाइब्रेरी में, फ़ॉरवर्ड करने वाले ये फ़ंक्शन जोड़ें.

void Java_com_example_yourapp_YourActivity_nativeOnActivityResult(
    JNIEnv* env,
    jobject thiz,
    jobject activity,
    jint request_code,
    jint result_code,
    jobject data) {
  gpg::AndroidSupport::OnActivityResult(
      env, activity, request_code, result_code, data);
}

सार्वजनिक स्टैटिक फ़ंक्शन
OnActivityCreated(JNIEnv *env, jobject activity, jobject saved_instance_state)	void इसे आपकी Java ऐक्टिविटी की onActivitycreated से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.
OnActivityDestroyed(JNIEnv *env, jobject activity)	void इसे आपकी Java गतिविधि के OnActivityDestroyed में से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.
OnActivityPaused(JNIEnv *env, jobject activity)	void यह वैल्यू आपकी Java गतिविधि के OnActivity इंडेक्स से डेटा फ़ॉरवर्ड करने के लिए कॉल की जानी चाहिए.
OnActivityResult(JNIEnv *env, jobject activity, jint request_code, jint result_code, jobject result)	void इसे आपकी Java गतिविधि के OnActivityresults से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.
OnActivityResumed(JNIEnv *env, jobject activity)	void यह आपकी Java गतिविधि के OnActivity एचटीएमएल की गतिविधि से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.
OnActivitySaveInstanceState(JNIEnv *env, jobject activity, jobject out_state)	void इसे आपकी Java गतिविधि के OnActivitySaveInstanceState से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.
OnActivityStarted(JNIEnv *env, jobject activity)	void इसे आपकी Java गतिविधि के OnActivityStarted से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.
OnActivityStopped(JNIEnv *env, jobject activity)	void इसे आपकी Java गतिविधि के OnActivitySstop से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

सार्वजनिक स्टैटिक फ़ंक्शन

OnActivityCreated

void gpg::AndroidSupport::OnActivityCreated(
  JNIEnv *env,
  jobject activity,
  jobject saved_instance_state
)

इसे आपकी Java ऐक्टिविटी की onActivitycreated से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

केवल Android 2.3.x समर्थन के लिए आवश्यक है.

OnActivityDestroyed

void gpg::AndroidSupport::OnActivityDestroyed(
  JNIEnv *env,
  jobject activity
)

इसे आपकी Java गतिविधि के OnActivityDestroyed में से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

केवल Android 2.3.x समर्थन के लिए आवश्यक है.

OnActivityPaused

void gpg::AndroidSupport::OnActivityPaused(
  JNIEnv *env,
  jobject activity
)

यह वैल्यू आपकी Java गतिविधि के OnActivity इंडेक्स से डेटा फ़ॉरवर्ड करने के लिए कॉल की जानी चाहिए.

केवल Android 2.3.x समर्थन के लिए आवश्यक है.

OnActivityResult

void gpg::AndroidSupport::OnActivityResult(
  JNIEnv *env,
  jobject activity,
  jint request_code,
  jint result_code,
  jobject result
)

इसे आपकी Java गतिविधि के OnActivityresults से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

OnActivityResumed

void gpg::AndroidSupport::OnActivityResumed(
  JNIEnv *env,
  jobject activity
)

यह आपकी Java गतिविधि के OnActivity एचटीएमएल की गतिविधि से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

केवल Android 2.3.x समर्थन के लिए आवश्यक है.

OnActivitySaveInstanceState

void gpg::AndroidSupport::OnActivitySaveInstanceState(
  JNIEnv *env,
  jobject activity,
  jobject out_state
)

यह आपकी Java गतिविधि के OnActivitySaveListenerState से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

केवल Android 2.3.x समर्थन के लिए आवश्यक है.

OnActivityStarted

void gpg::AndroidSupport::OnActivityStarted(
  JNIEnv *env,
  jobject activity
)

इसे आपकी Java गतिविधि के OnActivityStarted से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

केवल Android 2.3.x समर्थन के लिए आवश्यक है.

OnActivityStopped

void gpg::AndroidSupport::OnActivityStopped(
  JNIEnv *env,
  jobject activity
)

इसे आपकी Java गतिविधि के OnActivitySstop से डेटा फ़ॉरवर्ड करने के लिए कॉल किया जाना चाहिए.

केवल Android 2.3.x समर्थन के लिए आवश्यक है.