このページは Cloud Translation API によって翻訳されました。

gpg::AndroidSupport

#include <android_support.h>

Android 4.0 より前のサポートを有効にする関数。

概要

Android ライフサイクルコールバック

Android 2.3 または 3.x のデバイス（API バージョン 14 より前）をターゲットとするアプリの場合、Play ゲームサービスにはアクティビティのライフサイクルコールバックを自動的に受け取る方法がありません。このような場合、Play ゲームサービスは所有者のアクティビティを利用してライフサイクルイベントを通知します。GameServices オブジェクトを所有するアクティビティは、自身のライフサイクルコールバック関数内から AndroidSupport::* 関数を呼び出す必要があります。これらの関数の引数は、Android から提供されるものと一致するため、追加の処理は必要ありません。

Android 4.0 以降（API バージョン 14 以降）を対象とするアプリでは、これらの関数呼び出しのほとんどは不要です。このようなアプリでは、OnActivityResult 関数のみを呼び出す必要があります。

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 アクティビティの OnActivityPaused からデータを転送するために呼び出す必要があります。
`OnActivityResult(JNIEnv *env, jobject activity, jint request_code, jint result_code, jobject result)`	`void` Java アクティビティの OnActivityResult からデータを転送するために呼び出す必要があります。
`OnActivityResumed(JNIEnv *env, jobject activity)`	`void` Java アクティビティの OnActivityResumed からデータを転送するために呼び出す必要があります。
`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 アクティビティの OnActivityStopped からデータを転送するために呼び出す必要があります。

静的パブリック関数

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 アクティビティの OnActivityPaused からデータを転送するために呼び出す必要があります。

Android 2.3.x をサポートする場合にのみ必要です。

OnActivityResult

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

Java アクティビティの OnActivityResult からデータを転送するために呼び出す必要があります。

OnActivityResumed

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

Java アクティビティの OnActivityResumed からデータを転送するために呼び出す必要があります。

Android 2.3.x をサポートする場合にのみ必要です。

OnActivitySaveInstanceState

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

Java アクティビティの OnActivitySaveInstanceState からデータを転送するために呼び出す必要があります。

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 アクティビティの OnActivityStopped からデータを転送するために呼び出す必要があります。

Android 2.3.x をサポートする場合にのみ必要です。