本頁面由 Cloud Translation API 翻譯而成。

全螢幕廣告的活動支援功能

SDK 執行階段對 SDK 啟動新活動的方式施加限制。這對全螢幕廣告格式來說是一大挑戰，一般必須分別啟動一個活動，才能進一步控管及改善使用者體驗。為解決這個問題，SDK 執行階段為沙箱活動推出了全新機制，

在 SDK 執行階段環境中載入的 SDK 無法直接在資訊清單中定義 <activity> 標記或啟動自己的活動。而是改為導入新的意圖動作 START_SANDBOXED_ACTIVITY。

雖然 SDK 也不能使用此動作啟動意圖，但 SDK 可以要求用戶端應用程式啟動此意圖接著，系統會建立平台定義的活動，並傳遞至 SDK。這項活動會在以下時間執行：程序與 SDK 相同

這樣 SDK 就能使用這個活動，導入及管理全螢幕廣告無須專人管理

平台提供的活動是標準的 android.app.Activity。會在用戶端應用程式的工作中啟動。

在 SDK 執行階段上建立活動

建立活動的主要方法有兩種：使用簡化的 Jetpack Activity Library，或直接與 Platform API 互動。

建議您使用 Activity 程式庫，因為將基本概念抽象化，簡化活動建立程序。

活動程式庫有三種：核心、用戶端和提供者。

這些程式庫引入下列 API：

SdkActivityLauncher：活動啟動器可讓 SDK 處理從用戶端應用程式的啟動活動。用戶端應用程式應建立啟動器，並以參數形式傳遞至 SDK 的 API 來啟動活動。
<T : Activity & LifecycleOwner> T.createSdkActivityLauncher(() -> Boolean ): 這個擴充功能函式可供用戶端應用程式從活動呼叫，以建立啟動器。
SdkActivityLauncher.launchSdkActivity(IBinder)：SDK 用於要求應用程式啟動活動的方法。

使用活動程式庫啟動活動的流程如下：

SDK 會新增將 SdkActivityLauncher 新增至任何要啟動活動的 API。
用戶端應用程式呼叫對其中一個活動使用 createSdkActivityLauncher 建立啟動器，可在 API 呼叫上傳遞至 SDK。
SDK 呼叫 SdkSandboxControllerCompat.registerSdkSandboxActivityHandler(SdkSandboxActivityHandlerCompat)敬上並擷取 ID 符記
SDK 呼叫 launchSdkActivity敬上來啟動活動。

，瞭解如何調查及移除這項存取權。

下圖顯示使用活動程式庫時的流程。

平台推出下列 API 來協助建立在 SDK 執行階段中管理沙箱活動：

SdkSandboxActivityHandler: 活動處理常式會用來在建立活動時通知 SDK，並由 SDK 註冊。
為了協助註冊活動處理常式，SDK 可以在 SdkSandboxController 下使用以下方法：
- .registerSdkSandboxActivityHandler(SdkSandboxActivityHandler): 註冊 SdkSandboxActivityHandler、會傳回 IBinder ID
- .unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler): 取消註冊已註冊的例項 SdkSandboxActivityHandler 使用這個符記
SdkSandboxManager.startSdkSandboxActivity(Activity, IBinder): 此方法從用戶端應用程式叫用後，會觸發建立 SDK 的活動。用戶端應用程式必須將所選啟動 Activity 和 SDK 的 Activity Handler ID 傳遞為參數。

如要使用 Platform API 啟動活動，SDK 必須按照下列流程操作：

SDK 使用提供的 API 註冊活動處理常式，並取得 ID。
SDK 會與用戶端應用程式共用這個 ID。
用戶端應用程式會呼叫這個方法，使用平台 API startSdkSandboxActivity(Activity, IBinder) 在 SDK 執行階段中啟動活動，並以參數為這個新活動選擇的啟動活動，以及活動處理常式的 ID。
平台會啟動 Activity，並透過 Activity Handler (SdkSandboxActivityHandler.onActivityCreated(Activity)) 中的回呼通知 SDK。
SDK 會使用活動填入廣告。

，瞭解如何調查及移除這項存取權。

使用 Platform API 可讓 SDK 負責 SdkSandboxActivityHandler 的用戶端應用程式在適當時機透過 API 傳回用戶端應用程式 ID，以及引導客戶應用程式使用

在以下流程圖中，範例 SDK 中的 launchActivity(AppCallback) 方法會預期回呼 (在 SDK 的 API 中定義)。這個回呼是由用來共用活動處理常式 (SdkSandboxActivityHandler) 的 SDK ID 轉傳給用戶端應用程式。

在 SDK 執行階段中，整合到用戶端應用程式檢視區塊階層的廣告會使用側邊管道，將 SDK 程序從 SDK 程序轉譯至用戶端應用程式的處理程序。

SDK 無法在 SDK 執行階段外使用相同的 View API，判斷使用者是否看到廣告，因為使用者不會看到廣告附加至應用程式視窗 (可視度)。

相反地，平台提供的活動會在 SDK 執行階段程序中原生執行，無需使用側邊管道，並允許 SDK 使用標準 Android Activity 和 View API。

由於導入方式不同，持續致力統合介面，可擷取可視度信號，而不受廣告載入環境的影響。