> For the complete documentation index, see [llms.txt](https://documentation.pushly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.pushly.com/pushly-ja/integration/implementation-steps/android/sdk-kotlin-java/sdkkrubakku.md). # SDKコールバック {% hint style="danger" %} すべての SDK コールバックは、アプリケーションのメイン `onCreate` メソッド内に配置して、すべてのイベントを適切に処理できるようにすることを推奨します。 {% endhint %} ## SDK ライフサイクルコールバック これらのコールバックは、SDK の読み込みと終了を監視するために実装できます。 これらのコールバックを実装するには、SDK の `registerSDKLifecycleCallbacks` メソッドを使用し、その中でコールバックを実装できます。 {% tabs %} {% tab title="Kotlin" %} ```kotlin PushSDK.registerPushSDKLifecycleCallbacks(object : PNPushSDKLifecycleCallbacks { // ここに関数のオーバーライドを追加 }) ``` {% endtab %} {% tab title="Java" %} ```java PushSDK.registerPushSDKLifecycleCallbacks(new PNPushSDKLifecycleCallbacks() { // ここに関数のオーバーライドを追加 }); ``` {% endtab %} {% endtabs %} 利用可能な SDK ライフサイクルコールバックは次のとおりです: ### 読み込み完了 このコールバックは、SDK の初期化が完了し、操作可能になったときに実行されます。 {% tabs %} {% tab title="Kotlin" %} ```kotlin override fun onPushSDKDidFinishLoading(configuration: PNApplicationConfig, subscriberStatus: PNSubscriberStatus) { // SDK の読み込み完了後に実行するコードを追加 } ``` {% endtab %} {% tab title="Java" %} ```java @Override public void onPushSDKDidFinishLoading(@NonNull PNApplicationConfig configuration, @NonNull PNSubscriberStatus subscriberStatus) { // SDK の読み込み完了後に実行するコードを追加 } ``` {% endtab %} {% endtabs %} ## 権限ライフサイクルコールバック これらのコールバックは、ユーザーの権限承認の変更を監視するために実装できます。 これらのコールバックを実装するには、SDK の `registerPermissionLifecycleCallbacks` メソッドを使用し、その中でコールバックを実装できます。 {% tabs %} {% tab title="Kotlin" %} ```kotlin PushSDK.registerPermissionLifecycleCallbacks(object : PNPermissionLifecycleCallbacks { // ここに関数のオーバーライドを追加 }) ``` {% endtab %} {% tab title="Java" %} ```java PushSDK.registerPermissionLifecycleCallbacks(new PNPermissionLifecycleCallbacks() { // ここに関数のオーバーライドを追加 }); ``` {% endtab %} {% endtabs %} 利用可能な権限ライフサイクルコールバックは次のとおりです: ### 権限ステータスの変更 このコールバックは、ユーザーの権限ステータス/認可が変更されたときに実行されます。 「 `response` 変数はユーザーの **新しい** 権限ステータス。 {% tabs %} {% tab title="Kotlin" %} ```kotlin override fun onPushSDKDidReceivePermissionResponse(response: PNPermissionResponse) { // ユーザーの通知権限が変更された後に実行するコードを追加 } ``` {% endtab %} {% tab title="Java" %} ```java @Override public void onPushSDKDidReceivePermissionResponse(@NonNull PNPermissionResponse response) { // ユーザーの通知権限が変更された後に実行するコードを追加 } ``` {% endtab %} {% endtabs %} ## 通知ライフサイクルコールバック これらのコールバックは、インプレッション、開封、その他の通知とのやり取りなどのイベントを監視するために実装できます。 これらのコールバックを実装するには、SDK の `registerNotificationLifecycleCallbacks` メソッドを使用し、その中でコールバックを実装できます。 {% tabs %} {% tab title="Kotlin" %} ```kotlin PushSDK.registerNotificationLifecycleCallbacks(object : PNNotificationLifecycleCallbacks { // ここに関数のオーバーライドを追加 }) ``` {% endtab %} {% tab title="Java" %} ```java PushSDK.registerNotificationLifecycleCallbacks(new PNNotificationLifecycleCallbacks() { // ここに関数のオーバーライドを追加 }); ``` {% endtab %} {% endtabs %} 利用可能な通知ライフサイクルコールバックは次のとおりです: ### 通知受信 このコールバックは、ユーザーが通知を受信したときに実行されます {% tabs %} {% tab title="Kotlin" %} ```kotlin override fun onPushSDKDidReceiveRemoteNotification(notification: PNNotification) { // サブスクライバーのデバイスが通知を受信した後に実行するコードを追加 } ``` {% endtab %} {% tab title="Java" %} ```java @Override public void onPushSDKDidReceiveRemoteNotification(@NonNull PNNotification notification) { // サブスクライバーのデバイスが通知を受信した後に実行するコードを追加 } ``` {% endtab %} {% endtabs %} ### URI/URL 宛先付きで通知が開かれた場合 このコールバックは、ランディング URL が付与された通知が開かれたときに実行されます。サブスクライバーは、その URL を表すビューへ移動させる必要があります。 このメソッドは Boolean の応答を想定しています。応答が `true` の場合、SDK はこの通知の開封に対して追加のアクションを実行しません。応答が `false` の場合、SDK は購読者を宛先 URL へ遷移させようとします。 {% tabs %} {% tab title="Kotlin" %} ```kotlin override fun onPushSDKDidReceiveNotificationDestination(destination: String, interaction: PNNotificationInteraction): Boolean { // destination（ランディング URL）を使用して、アプリケーション内のアクティビティへ遷移する // SDK に対して遷移しないよう通知するために true を返す return true } ``` {% endtab %} {% tab title="Java" %} ```java @Override public boolean onPushSDKDidReceiveNotificationDestination(@NonNull String destination, @NonNull PNNotificationInteraction pnNotificationInteraction) { // destination（ランディング URL）を使用して、アプリケーション内のアクティビティへ遷移する // SDK に対して遷移しないよう通知するために true を返す return true; } ``` {% endtab %} {% endtabs %} 次を参照してください。 [ディープリンク](/pushly-ja/integration/implementation-steps/android/sdk-kotlin-java/dpurinku.md) 完全な例についてはドキュメントを参照してください。 ## アプリメッセージライフサイクルコールバック これらのコールバックは、インプレッション、開封、その他のアプリメッセージとのやり取りなどのイベントを監視するために実装できます。 これらのコールバックを実装するには、SDK の `registerAppMessageLifecycleCallbacks` メソッドを使用し、その中でコールバックを実装できます。 {% tabs %} {% tab title="Kotlin" %} ```kotlin PushSDK.registerAppMessageLifecycleCallbacks(object : PNAppMessageLifecycleCallbacks { // ここに関数のオーバーライドを追加 }) ``` {% endtab %} {% tab title="Java" %} ```java PushSDK.registerAppMessageLifecycleCallbacks(new PNAppMessageLifecycleCallbacks() { // ここに関数のオーバーライドを追加 }); ``` {% endtab %} {% endtabs %} 利用可能なアプリメッセージライフサイクルコールバックは次のとおりです: ### アプリメッセージ表示時 このコールバックは、アプリメッセージがユーザーに表示されたときに実行されます。 {% tabs %} {% tab title="Kotlin" %} ```kotlin override fun onPushSDKWillPresentAppMessage(appMessage: PNAppMessage) { // ユーザーのデバイスにアプリメッセージが表示されたときに実行するコードを追加 } ``` {% endtab %} {% tab title="Java" %} ```java @Override public void onPushSDKWillPresentAppMessage(@NonNull PNAppMessage appMessage) { // ユーザーのデバイスにアプリメッセージが表示されたときに実行するコードを追加 } ``` {% endtab %} {% endtabs %} ### アプリメッセージでユーザーが操作したとき このコールバックは、ユーザーがアプリメッセージとやり取りしたときに実行されます。 このメソッドは Boolean の応答を想定しています。応答が `true` その場合、SDK はそのインタラクションを処理せず、Open URL アクションの場合もナビゲーションを試みません。応答が `false` の場合、SDK はそのインタラクションを処理し、インタラクションが Open URL アクションの場合は、 `open` メソッド内に追加します。 {% tabs %} {% tab title="Swift" %} ```kotlin override fun onPushSDKDidReceiveAppMessageInteraction(interaction: PNAppMessageInteraction, appMessage: PNAppMessage): Boolean { // ユーザーがアプリメッセージとやり取りしたときに実行するコードを追加 // SDK がそのインタラクションを処理しないようにするには true を返します return true } ``` {% endtab %} {% tab title="Java" %} ```java @Override public boolean onPushSDKDidReceiveAppMessageInteraction(@NonNull PNAppMessageInteraction interaction, @NonNull PNAppMessage appMessage) { // destination（ランディング URL）を使用して、アプリケーション内のアクティビティへ遷移する // SDK に対して遷移しないよう通知するために true を返す return true; } ``` {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://documentation.pushly.com/pushly-ja/integration/implementation-steps/android/sdk-kotlin-java/sdkkrubakku.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.