SdkSandboxController

public class SdkSandboxController
extends Object

java.lang.Object
   ↳ android.app.sdksandbox.sdkprovider.SdkSandboxController


在沙箱中載入的 SDK 所使用的控制器,可存取 SDK 沙箱提供的資訊。

可讓 SDK 與 SDK 沙箱中的其他 SDK 通訊,並瞭解目前載入的 SDK 狀態。

您可以使用 Context.getSystemService(Class)class 取得 SdkSandboxController 的執行個體。接著,您可以使用 SandboxedSdkProvider.getContext() 取得 Context

摘要

常數

String SDK_SANDBOX_CONTROLLER_SERVICE

公用方法

List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces()

擷取應用程式註冊的所有 AppOwnedSdkSandboxInterface

SharedPreferences getClientSharedPreferences()

傳回 SharedPreferences,其中包含從用戶端應用程式同步處理的資料。

List<SandboxedSdk> getSandboxedSdks()

擷取在沙箱中載入的 Sdks 相關資訊。

IBinder registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

在註冊 SdkSandboxActivityHandler 後傳回 ID。

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

取消註冊已註冊的 SdkSandboxActivityHandler

繼承方法

常數

SDK_SANDBOX_}{LER_SERVICE

public static final String SDK_SANDBOX_CONTROLLER_SERVICE

常數值: "sdk_sandbox_controller_service"

公用方法

getAppOwnedSdkSandboxInterfaces

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

擷取應用程式註冊的所有 AppOwnedSdkSandboxInterface

傳回
List<AppOwnedSdkSandboxInterface> AppOwnedSdkSandboxInterface 清單,包含所有目前已註冊的 AppOwnedSdkSandboxInterface。 此值不能為 null

擲回
UnsupportedOperationException 如果控制器是從非預期的內容中取得,使用「SandboxedSdkProvider#getContext()」以取得合適的背景資訊

getClientSharedPreferences

public SharedPreferences getClientSharedPreferences ()

傳回 SharedPreferences,其中包含從用戶端應用程式同步處理的資料。

這個 SharedPreferences 中,用戶端應用程式已使用 SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) 同步處理的金鑰。

傳回的 SharedPreferences 不應處於讀取狀態。不支援寫入資料。

傳回
SharedPreferences SharedPreferences,包含從用戶端應用程式同步處理的資料。 此值不能為 null

擲回
UnsupportedOperationException 如果控制器是從非預期的內容中取得,使用「SandboxedSdkProvider#getContext()」以取得合適的背景資訊

getSandboxedSdks

public List<SandboxedSdk> getSandboxedSdks ()

擷取在沙箱中載入的 Sdks 相關資訊。

傳回
List<SandboxedSdk> SandboxedSdk 清單,包含目前載入的所有 SDK 此值不能為 null

擲回
UnsupportedOperationException 如果控制器是從非預期的內容中取得,使用「SandboxedSdkProvider#getContext()」以取得合適的背景資訊

RegisterSdkSandboxActivityHandler

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

在註冊 SdkSandboxActivityHandler 後傳回 ID。

這個函式會註冊 SDK 建立的 SdkSandboxActivityHandler 實作項目,並傳回 IBinder,用於識別傳遞的 SdkSandboxActivityHandler 物件。

如果多次註冊同一個 SdkSandboxActivityHandler 且未經取消註冊,系統會傳回相同的 IBinder 權杖。

參數
sdkSandboxActivityHandler SdkSandboxActivityHandler:要註冊的 SdkSandboxActivityHandler。此值不能為 null

傳回
IBinder IBinder 可明確識別傳遞的 SdkSandboxActivityHandler。此值不能為 null

unregisterSdkSandboxActivityHandler

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

取消註冊已註冊的 SdkSandboxActivityHandler

如果已註冊的 SdkSandboxActivityHandler 已註冊,則會取消註冊。否則,系統不會採取任何行動。

取消註冊後,SDK 可以再次註冊相同的處理常式物件,或是建立新物件 (如果需要新的 Activity)。

如果用於啟動 Activity 的未註冊處理常式的 IBinder 權杖,Activity 將無法啟動。

參數
sdkSandboxActivityHandler SdkSandboxActivityHandler:要取消註冊的 SdkSandboxActivityHandler。 此值不能為 null

傳回
void 此值不能為 null