gpg::AndroidSupport

#include <android_support.h>

Funzioni che supportano il supporto delle versioni precedenti ad Android 4.0.

Riepilogo

Callback del ciclo di vita Android

Per le app che hanno come target dispositivi Android 2.3 o 3.x (versione API precedente alla 14), Play Game Services non ha modo di ricevere automaticamente i callback del ciclo di vita delle attività. In questi casi, i servizi per i giochi di Play si basano sull'attività proprietaria per notificare gli eventi del ciclo di vita. Qualsiasi attività proprietaria di un oggetto GameServices deve chiamare le funzioni AndroidSupport::* dall'interno delle funzioni di callback del proprio ciclo di vita. Gli argomenti in queste funzioni corrispondono a quelli forniti da Android, quindi non è necessaria alcuna elaborazione aggiuntiva.

Per le app destinate ad Android 4.0 o versioni successive (versione API successiva o uguale a 14), la maggior parte di queste chiamate di funzione non è necessaria. Per queste app è necessario chiamare solo la funzione OnActivityResult.

Codice di esempio per un gioco di versioni precedenti ad Android 4.0 che utilizza un'attività Java

Aggiungi quanto segue nell'attività Java. Potrebbe essere necessario unire questo codice alle funzioni esistenti del tuo ciclo di vita.

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);
}

Quindi, nella tua libreria nativa, aggiungi le seguenti funzioni di forwarding.

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);
}

Codice di esempio per un gioco Android 4.0 o versioni successive che utilizza un'attività Java

Aggiungi quanto segue nell'attività Java. Potrebbe essere necessario unire questo codice alle funzioni esistenti del tuo ciclo di vita.

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);
}

Quindi, nella tua libreria nativa, aggiungi le seguenti funzioni di forwarding.

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);
}

Funzioni statiche pubbliche
OnActivityCreated(JNIEnv *env, jobject activity, jobject saved_instance_state)	void Deve essere chiamato per inoltrare i dati da onActivityCreated dell'attività Java.
OnActivityDestroyed(JNIEnv *env, jobject activity)	void Deve essere chiamato per inoltrare i dati dall'attività OnActivityDestroyed dell'attività Java.
OnActivityPaused(JNIEnv *env, jobject activity)	void Deve essere chiamato per inoltrare i dati da OnActivityPausa dell'attività Java.
OnActivityResult(JNIEnv *env, jobject activity, jint request_code, jint result_code, jobject result)	void Deve essere chiamato per inoltrare i dati dall'OnActivityResult dell'attività Java.
OnActivityResumed(JNIEnv *env, jobject activity)	void Deve essere chiamato per inoltrare i dati dall'OnActivityActivated dell'attività Java.
OnActivitySaveInstanceState(JNIEnv *env, jobject activity, jobject out_state)	void Deve essere chiamato per inoltrare i dati dall'OnActivitySaveInstanceState dell'attività Java.
OnActivityStarted(JNIEnv *env, jobject activity)	void Deve essere chiamato per inoltrare i dati da OnActivityStarted dell'attività Java.
OnActivityStopped(JNIEnv *env, jobject activity)	void Deve essere chiamato per inoltrare i dati dall'attività OnActivitySended dell'attività Java.

Funzioni statiche pubbliche

OnActivityCreated

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

Deve essere chiamato per inoltrare i dati da onActivityCreated dell'attività Java.

Necessario solo per il supporto Android 2.3.x.

OnActivityDestroyed

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

Deve essere chiamato per inoltrare i dati dall'attività OnActivityDestroyed dell'attività Java.

Necessario solo per il supporto Android 2.3.x.

OnActivityPaused

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

Deve essere chiamato per inoltrare i dati da OnActivityPausa dell'attività Java.

Necessario solo per il supporto Android 2.3.x.

OnActivityResult

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

Deve essere chiamato per inoltrare i dati dall'OnActivityResult dell'attività Java.

OnActivityResumed

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

Deve essere chiamato per inoltrare i dati dall'OnActivityActivated dell'attività Java.

Necessario solo per il supporto Android 2.3.x.

OnActivitySaveInstanceState

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

Deve essere chiamato per inoltrare i dati dall'OnActivitySaveInstanceState dell'attività Java.

Necessario solo per il supporto Android 2.3.x.

OnActivityStarted

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

Deve essere chiamato per inoltrare i dati da OnActivityStarted dell'attività Java.

Necessario solo per il supporto Android 2.3.x.

OnActivityStopped

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

Deve essere chiamato per inoltrare i dati dall'attività OnActivitySended dell'attività Java.

Necessario solo per il supporto Android 2.3.x.