Pakiet SDK pakietu SDK

public final class SdkSandboxManager
extends Object

java.lang.Object
↳ android.app.sdksandbox.SdkSandboxManager

Udostępnia interfejsy API umożliwiające wczytywanie usługi SDKs do w piaskownicy SDK, a następnie wchodzić z nimi w interakcję.

Piaskownica pakietu SDK to proces języka Java działający w osobnym zakresie identyfikatorów UID. Każda aplikacja może mieć własny pakiet SDK w trybie piaskownicy.

Aplikacja musi najpierw zadeklarować pakiety SDK, od których jest zależna, w pliku manifestu za pomocą tagu <uses-sdk-library>. Aplikacje mogą wczytywać w piaskownicy SDK tylko zależne pakiety SDK.

Podsumowanie

Zagnieżdżone klasy

interface SdkSandboxManager.SdkSandboxProcessDeathCallback

Wywołanie zwrotne dla śledzenia zdarzeń w piaskownicy SDK. 

Stałe

String EXTRA_DISPLAY_ID

Nazwa klucza, która ma być używana w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna definiować identyfikator całkowity funkcji logicznej aby wyświetlić SurfacePackage.

String EXTRA_HEIGHT_IN_PIXELS

Nazwa klucza, która ma być używana w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna określać wysokość całkowitą z SurfacePackage w pikselach.

String EXTRA_HOST_TOKEN

Nazwa klucza, który ma być używany w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna zawierać token zwrócony przez SurfaceView.getHostToken() po zmodyfikowaniu SurfaceView. dodano do hierarchii widoków.

String EXTRA_SURFACE_PACKAGE

Nazwa klucza w pakiecie, która jest przekazywana do funkcji onResult w OutcomeReceiver, która jest polem requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość zawiera żądane SurfacePackage.

String EXTRA_WIDTH_IN_PIXELS

Nazwa klucza, która ma być używana w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna definiować szerokość całkowitą z SurfacePackage w pikselach.

int LOAD_SDK_ALREADY_LOADED

Pakiet SDK jest już wczytany.

int LOAD_SDK_INTERNAL_ERROR

Podczas wczytywania pakietu SDK wystąpił błąd wewnętrzny.

int LOAD_SDK_NOT_FOUND

Nie znaleziono pakietu SDK.

int LOAD_SDK_SDK_DEFINED_ERROR

Po załadowaniu wystąpił błąd pakietu SDK.

int LOAD_SDK_SDK_SANDBOX_DISABLED

Piaskownica pakietu SDK jest wyłączona.

int REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR

Podczas wysyłania żądania dotyczącego elementu SurfacePackage wystąpił błąd wewnętrzny.

int REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED

Podczas żądania SurfacePackage nie wczytano pakietu SDK.

int SDK_SANDBOX_PROCESS_NOT_AVAILABLE

Proces piaskownicy SDK jest niedostępny.

String SDK_SANDBOX_SERVICE

Użyj razem z Context#getSystemService(String), aby pobrać SdkSandboxManager za interakcję z pakietami SDK należącymi do tej aplikacji klienckiej.

int SDK_SANDBOX_STATE_DISABLED

Piaskownica pakietu SDK jest wyłączona.

int SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

Piaskownica pakietu SDK jest włączona.

Metody publiczne

void addSdkSandboxProcessDeathCallback(Executor callbackExecutor, SdkSandboxManager.SdkSandboxProcessDeathCallback callback)

Dodaje wywołanie zwrotne rejestrowane w przypadku zdarzeń cyklu życia piaskownicy SDK, takich jak piaskownica SDK. śmierci.

void addSyncedSharedPreferencesKeys(Set<String> keys)

Dodaje do pakietu SDK klucze do zestawu kluczy z domyślnego SharedPreferences aplikacji w środowisku piaskownicy.

List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces()

Pobiera listę adresów AppOwnedSdkSandboxInterface zarejestrowanych w aplikacji

List<SandboxedSdk> getSandboxedSdks()

Pobiera informacje o pakietach SDK wczytywanych do piaskownicy.

static int getSdkSandboxState()

Zwraca bieżący stan dostępności funkcji piaskownicy SDK.

Set<String> getSyncedSharedPreferencesKeys()

Zwraca ustawione klucze, które są synchronizowane z domyślnego klucza SharedPreferences aplikacji w do piaskownicy SDK.

void loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)

Wczytuje pakiet SDK w procesie Java sandbox w trybie piaskownicy.

void registerAppOwnedSdkSandboxInterface(AppOwnedSdkSandboxInterface appOwnedSdkSandboxInterface)

Rejestruje AppOwnedSdkSandboxInterface w procesie aplikacji.

void removeSdkSandboxProcessDeathCallback(SdkSandboxManager.SdkSandboxProcessDeathCallback callback)

Usuwa pole SdkSandboxProcessDeathCallback, które zostało wcześniej dodane za pomocą pola addSdkSandboxProcessDeathCallback(java.util.concurrent.Executor, android.app.sdksandbox.SdkSandboxManager.SdkSandboxProcessDeathCallback)

void removeSyncedSharedPreferencesKeys(Set<String> keys)

Usuwa klucze z zestawu kluczy, które zostały dodane za pomocą funkcji addSyncedSharedPreferencesKeys(java.util.Set)

Usunięte klucze zostaną wymazane z piaskownicy SDK, jeśli zostały już zsynchronizowane.

void requestSurfacePackage(String sdkName, Bundle params, Executor callbackExecutor, OutcomeReceiver<Bundle, RequestSurfacePackageException> receiver)

Wysyła żądanie pakietu powierzchni do SDK.

void startSdkSandboxActivity(Activity fromActivity, IBinder sdkActivityToken)

Uruchamia Activity w piaskownicy SDK.

void unloadSdk(String sdkName)

Wyładowuje pakiet SDK, który został wcześniej załadowany przez element wywołujący.

void unregisterAppOwnedSdkSandboxInterface(String name)

Wyrejestrowuje domenę ERROR(/AppOwnedSdkSandboxInterfaces) z procesu aplikacji.

Metody dziedziczone

Stałe

EXTRA_DISPLAY_ID

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final String EXTRA_DISPLAY_ID

Nazwa klucza, która ma być używana w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna definiować identyfikator całkowity funkcji logicznej. aby wyświetlić SurfacePackage.

Wartość stała: „android.app.sdksandbox.extra.DISPLAY_ID”

EXTRA_HEIGHT_IN_PIXELS

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final String EXTRA_HEIGHT_IN_PIXELS

Nazwa klucza, która ma być używana w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna określać wysokość całkowitą z SurfacePackage w pikselach.

Wartość stała: „android.app.sdksandbox.extra.HEIGHT_IN_PIXELS”

EXTRA_HOST_TOKEN

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final String EXTRA_HOST_TOKEN

Nazwa klucza, który ma być używany w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna zawierać token zwrócony przez SurfaceView.getHostToken() po zmodyfikowaniu SurfaceView. dodano do hierarchii widoków. Do włączenia raportowania błędów ANR dopuszczana jest tylko wartość inna niż null.

Wartość stała: „android.app.sdksandbox.extra.HOST_TOKEN”

EXTRA_SURFACE_PACKAGE

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final String EXTRA_SURFACE_PACKAGE

Nazwa klucza w pakiecie, która jest przekazywana do funkcji onResult w OutcomeReceiver, która jest polem requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość zawiera żądane SurfacePackage.

Wartość stała: „android.app.sdksandbox.extra.SURFACE_PACKAGE”

EXTRA_WIDTH_IN_PIXELS

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final String EXTRA_WIDTH_IN_PIXELS

Nazwa klucza, która ma być używana w polach pakietu requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver). Jego wartość powinna określać szerokość całkowitą z SurfacePackage w pikselach.

Wartość stała: „android.app.sdksandbox.extra.WIDTH_IN_PIXELS”

LOAD_SDK_ALREADY_LOADED

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final int LOAD_SDK_ALREADY_LOADED

Pakiet SDK jest już wczytany.

Oznacza to, że aplikacja kliencka próbowała ponownie załadować ten sam pakiet SDK, wywołując interfejs loadSdk(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver) po udało się załadować.

Wartość stała: Poradnik (0x00000065)

BŁĄD_WEWNĘTRZNY LOAD_SDK_INTERNAL_ERROR

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final int LOAD_SDK_INTERNAL_ERROR

Podczas wczytywania pakietu SDK wystąpił błąd wewnętrzny.

Oznacza to, że podczas wykonywania połączenia przez klienta wystąpił ogólny błąd wewnętrzny aplikacji.

Wartość stała: 500 (0x000001f4)

NIE ZNALEZIONO LOAD_SDK_NOT_FOUND

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final int LOAD_SDK_NOT_FOUND

Nie znaleziono pakietu SDK.

Oznacza to, że aplikacja kliencka próbowała wczytać nieistniejący pakiet SDK, wywołując loadSdk(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver).

Wartość stała: 100 (0x00000064)

LOAD_SDK_SDK_DEFINED_ERROR

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final int LOAD_SDK_SDK_DEFINED_ERROR

Po załadowaniu wystąpił błąd pakietu SDK.

Oznacza to, że podczas inicjowania po wczytaniu w pakiecie SDK wystąpił błąd. Szczegóły tego pakietu można uzyskać z pakietu zwróconego w LoadSdkException przez OutcomeReceiver przekazać do SdkSandboxManager#loadSdk.

Wartość stała: 102 (0x00000066)

LOAD_SDK_SDK_SANDBOX_DISABLED

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final int LOAD_SDK_SDK_SANDBOX_DISABLED

Piaskownica pakietu SDK jest wyłączona.

Oznacza to, że piaskownica SDK jest wyłączona. Wszelkie kolejne próby załadowania pakietów SDK również ten proces się nie powiedzie.

Wartość stała: 103 (0x00000067)

REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final int REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR

Podczas wysyłania żądania dotyczącego elementu SurfacePackage wystąpił błąd wewnętrzny.

Oznacza to, że podczas wysyłania żądania o SurfacePackage

Wartość stała: 700 (0x000002bc)

REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 5 
public static final int REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED

Podczas żądania SurfacePackage nie wczytano pakietu SDK.

Oznacza to, że pakiet SDK, którego dotyczy żądanie SurfacePackage, nie jest ponieważ piaskownica przestała działać lub w ogóle się nie załadowała.

Wartość stała: 701 (0x000002bd)

SDK_SANDBOX_PROCES_NIEDOSTĘPNY

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final int SDK_SANDBOX_PROCESS_NOT_AVAILABLE

Proces piaskownicy SDK jest niedostępny.

Oznacza to, że proces piaskownicy SDK jest niedostępny. lub nie został utworzony.

Wartość stała: 503 (0X000001F7)

SDK_SANDBOX_SERVICE

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4 
public static final String SDK_SANDBOX_SERVICE

Użyj razem z Context#getSystemService(String), aby pobrać SdkSandboxManager za interakcję z pakietami SDK należącymi do tej aplikacji klienckiej.

Wartość stała: „sdk_sandbox”

SDK_SANDBOX_STATE_DISABLED

Dodano na poziomie API 33
Również w rozszerzeniach usług reklamowych 3 
public static final int SDK_SANDBOX_STATE_DISABLED

Piaskownica pakietu SDK jest wyłączona.

SdkSandboxManager interfejsów API jest ukrytych. Próba nawiązania połączenia zakończy się wynikiem UnsupportedOperationException.

Wartość stała: 0 (0x00000000)

SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

Dodano na poziomie API 33
Również w rozszerzeniach usług reklamowych 3 
public static final int SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

Piaskownica pakietu SDK jest włączona.

Aplikacja może używać interfejsów API SdkSandboxManager do wczytywania w obiekcie SDKs, od którego zależy, odpowiedni proces piaskownicy SDK.

Wartość stała: 2. (0x00000002)

Metody publiczne

Wywołanie zwrotne addSdkSandboxProcessDeathCallback

public void addSdkSandboxProcessDeathCallback (Executor callbackExecutor, 
                SdkSandboxManager.SdkSandboxProcessDeathCallback callback)

Dodaje wywołanie zwrotne rejestrowane w przypadku zdarzeń cyklu życia piaskownicy SDK, takich jak piaskownica SDK. śmierci. Jeśli piaskownica nie została jeszcze utworzona w momencie wywołania tego żądania, żądanie zostanie przechowywane do momentu utworzenia piaskownicy, kiedy to zostaje włączona. Wiele wywołania zwrotne można dodawać, by wykrywać śmierć. Nie są one usuwane, gdy piaskownica przestanie działać.

Parametry
callbackExecutor Executor: pole Executor, które ma wywołać wywołanie zwrotne Ta wartość nie może być null. Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora Executor, co pozwala łatwo kontrolować, który wątek jest . Aby wysyłać zdarzenia przez wątek główny aplikacji, możesz użyć Context.getMainExecutor() W przeciwnym razie podaj Executor, który wysyła do odpowiedniego wątku.
callback SdkSandboxManager.SdkSandboxProcessDeathCallback: SdkSandboxProcessDeathCallback, który otrzyma piaskownicę SDK zdarzenia cyklu życia. Ta wartość nie może być typu null.

addSyncedSharedPreferencesKeys

public void addSyncedSharedPreferencesKeys (Set<String> keys)

Dodaje do pakietu SDK klucze do zestawu kluczy z domyślnego SharedPreferences aplikacji w środowisku piaskownicy.

Zsynchronizowane dane będą dostępne dla pakietów SDK do odczytu za pomocą interfejsu API SdkSandboxController.getClientSharedPreferences().

Aby zatrzymać synchronizację klucza dodanego za pomocą tego interfejsu API, użyj funkcji removeSyncedSharedPreferencesKeys(java.util.Set).

Synchronizacja przestaje działać, jeśli aplikacja uruchomi się ponownie i użytkownik będzie musiał ponownie wywołać ten interfejs API, aby odbudować pulę. kluczy do synchronizacji.

Uwaga: te zajęcia nie obsługują użycia w wielu procesach.

Parametry
keys Set: zestaw kluczy, które będą synchronizowane z piaskownicą. Ta wartość nie może być typu null.

getAppownedSdkSandboxInterfaces (Interfaces)

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Pobiera listę adresów AppOwnedSdkSandboxInterface zarejestrowanych w aplikacji

Zwroty
List<AppOwnedSdkSandboxInterface> pusta lista, jeśli na mapie nie znaleziono metody callInfo, w przeciwnym razie lista wartości AppOwnedSdkSandboxInterface Ta wartość nie może być typu null.

getSandboxedSdks,

public List<SandboxedSdk> getSandboxedSdks ()

Pobiera informacje o pakietach SDK wczytywanych do piaskownicy.

Zwroty
List<SandboxedSdk> Lista SandboxedSdk zawierająca wszystkie obecnie wczytane pakiety SDK. Ta wartość nie może być typu null.

getSdkSandboxState,

public static int getSdkSandboxState ()

Zwraca bieżący stan dostępności funkcji piaskownicy SDK.

Zwroty
int Wartość to SDK_SANDBOX_STATE_DISABLED, czyli SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

getSyncedSharedPreferencesKeys (klucze getSyncedSharedPreferencesKeys)

public Set<String> getSyncedSharedPreferencesKeys ()

Zwraca ustawione klucze, które są synchronizowane z domyślnego klucza SharedPreferences aplikacji w do piaskownicy SDK.

Zwroty
Set<String> Ta wartość nie może być typu null.

loadSdk

public void loadSdk (String sdkName, 
                Bundle params, 
                Executor executor, 
                OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)

Wczytuje pakiet SDK w procesie Java sandbox w trybie piaskownicy.

Wczytuje bibliotekę SDK z parametrem sdkName do procesu piaskownicy SDK asynchronicznie. rozmówca zostanie powiadomiony przez: receiver

Element wywołujący powinien już zadeklarować element SDKs, od którego zależy, w swoim pliku manifestu za pomocą tagu <uses-sdk-library>. Element wywołujący może wczytać do pakietu SDK tylko SDKs, od którego zależy w środowisku piaskownicy.

Gdy aplikacja kliencka wczyta pierwszy pakiet SDK, zostanie uruchomiony nowy proces piaskownicy SDK Utworzono. Jeśli dla aplikacji klienckiej została już utworzona piaskownica, dodatkowe pakiety SDK zostanie wczytany do tej samej piaskownicy.

Ten interfejs API może być wywoływany tylko wtedy, gdy element wywołujący działa na pierwszym planie. Połączenia z w tle zwróci wartość LoadSdkException w receiver.

Parametry
sdkName String: nazwa pakietu SDK do wczytania. Ta wartość nie może być typu null.
params Bundle: dodatkowe parametry, które należy przekazać do SDK w postaci Bundle. zgodnie z ustaleniami między klientem a pakietem SDK. Ta wartość nie może być typu null.
executor Executor: Executor, na którym ma zostać wywołany odbiornik. Ta wartość nie może być typu null. Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora Executor, co pozwala łatwo kontrolować, który wątek jest . Aby wysyłać zdarzenia przez wątek główny aplikacji, możesz użyć Context.getMainExecutor() W przeciwnym razie podaj Executor, który wysyła do odpowiedniego wątku.
receiver OutcomeReceiver: otrzymuje SandboxedSdk po udanym uruchomieniu lub LoadSdkException. Ta wartość nie może być typu null.

RejestrowanieAplikacjiSdkSandboxInterface

public void registerAppOwnedSdkSandboxInterface (AppOwnedSdkSandboxInterface appOwnedSdkSandboxInterface)

Rejestruje AppOwnedSdkSandboxInterface w procesie aplikacji.

Rejestrowanie obiektu AppOwnedSdkSandboxInterface o tej samej nazwie co poprzednio zarejestrowanego interfejsu zwróci wartość IllegalStateException.

AppOwnedSdkSandboxInterface#getName() odnosi się do nazwy interfejsu.

Parametry
appOwnedSdkSandboxInterface AppOwnedSdkSandboxInterface: AppOwnerSdkSandboxInterface do zarejestrowania Ta wartość nie może być typu null.

deleteSdkSandboxProcessDeathCallback 

public void removeSdkSandboxProcessDeathCallback (SdkSandboxManager.SdkSandboxProcessDeathCallback callback)

Usuwa pole SdkSandboxProcessDeathCallback, które zostało wcześniej dodane za pomocą pola addSdkSandboxProcessDeathCallback(java.util.concurrent.Executor, android.app.sdksandbox.SdkSandboxManager.SdkSandboxProcessDeathCallback)

Parametry
callback SdkSandboxManager.SdkSandboxProcessDeathCallback: pole SdkSandboxProcessDeathCallback dodane wcześniej za pomocą SdkSandboxManager#addSdkSandboxProcessDeathCallback(Executor, SdkSandboxProcessDeathCallback) Ta wartość nie może być typu null.

deleteSyncedSharedPreferencesKeys

public void removeSyncedSharedPreferencesKeys (Set<String> keys)

Usuwa klucze z zestawu kluczy, które zostały dodane za pomocą funkcji addSyncedSharedPreferencesKeys(java.util.Set)

Usunięte klucze zostaną wymazane z piaskownicy SDK, jeśli zostały już zsynchronizowane.

Parametry
keys Set: zestaw nazw kluczy, które nie powinny być już synchronizowane z piaskownicą. Ta wartość nie może być typu null.

requestSurfacePackage

public void requestSurfacePackage (String sdkName, 
                Bundle params, 
                Executor callbackExecutor, 
                OutcomeReceiver<Bundle, RequestSurfacePackageException> receiver)

Wysyła żądanie pakietu powierzchni do SDK.

Gdy aplikacja kliencka otrzyma sygnał o prawidłowym załadowaniu pakietu SDK i sprawi dodał do hierarchii widoków element SurfaceView, może asynchronicznie SurfacePackage, by renderować widok z pakietu SDK.

Gdy SurfacePackage będzie gotowy, wywołanie zwrotne OutcomeReceiver#onResult z zostanie wywołana wartość receiver. To wywołanie zwrotne będzie zawierać: Bundle który będzie zawierał klucz SdkSandboxManager#EXTRA_SURFACE_PACKAGE, którego powiązana wartość to żądane SurfacePackage.

Przekazana wartość params musi zawierać te klucze: EXTRA_WIDTH_IN_PIXELS, SdkSandboxManager#EXTRA_HEIGHT_IN_PIXELS, SdkSandboxManager#EXTRA_DISPLAY_ID i SdkSandboxManager#EXTRA_HOST_TOKEN. Jeśli brakuje któregoś z tych kluczy lub jest on nieprawidłowy, zgłaszany jest parametr IllegalArgumentException.

Ten interfejs API może być wywoływany tylko wtedy, gdy element wywołujący działa na pierwszym planie. Połączenia z background spowoduje zwrócenie wyjątku RequestSurfacePackageException w obiekcie receiver.

Parametry
sdkName String: nazwa pakietu SDK wczytanego do piaskownicy SDK. Ta wartość nie może być typu null.
params Bundle: parametry, które aplikacja kliencka przekazuje do pakietu SDK. Ta wartość nie może być typu null.
callbackExecutor Executor: pole Executor, które ma wywołać wywołanie zwrotne Ta wartość nie może być null. Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora Executor, co pozwala łatwo kontrolować, który wątek jest . Aby wysyłać zdarzenia przez wątek główny aplikacji, możesz użyć Context.getMainExecutor() W przeciwnym razie podaj Executor, który wysyła do odpowiedniego wątku.
receiver OutcomeReceiver: w przypadku powodzenia zwraca wartość Bundle, która zawiera klucz SdkSandboxManager#EXTRA_SURFACE_PACKAGE z wartością SurfacePackage lub RequestSurfacePackageException w przypadku niepowodzenia. Ta wartość nie może być typu null.
Rzuty
IllegalArgumentException jeśli params nie zawiera wszystkich wymaganych kluczy.

startSdkSandboxActivity

public void startSdkSandboxActivity (Activity fromActivity, 
                IBinder sdkActivityToken)

Uruchamia Activity w piaskownicy SDK.

Ta funkcja uruchomi nowe zadanie Activity w tym samym zadaniu przekazanego fromActivity i przekaże ją do pakietu SDK udostępniającego przekazane sdkActivityToken, które: identyfikuje żądanie wysłane z tego pakietu SDK, które zawiera wartość Activity.

Activity nie uruchamia się w tych przypadkach:

  • Aplikacja wywołująca ten interfejs API działa w tle.
  • Przekazana wartość sdkActivityToken nie odpowiada żądaniu Activity za pomocą pakietu SDK, który udostępnił go aplikacji wywołującej.
  • Pakiet SDK, który udostępnił przekazany pakiet sdkActivityToken, usunął żądanie dotyczące tego Activity
  • Piaskownica Activity została już utworzona.

Parametry
fromActivity Activity: obiekt Activity zostanie użyty do uruchomienia nowej piaskownicy Activity przez wywołanie dla niej funkcji Activity#startActivity(Intent). Ta wartość nie może być typu null.
sdkActivityToken IBinder: identyfikator udostępniany przez pakiet SDK, który wysyła żądanie do Activity. Ta wartość nie może być typu null.

unloadSdk

public void unloadSdk (String sdkName)

Wyładowuje pakiet SDK, który został wcześniej załadowany przez element wywołujący.

Nie gwarantujemy, że pamięć przydzielona temu pakietowi SDK zostanie natychmiast zwolniona. Wszystkie kolejne wywołania requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver) dla danej wartości sdkName nie powiedzie się.

Ten interfejs API może być wywoływany tylko wtedy, gdy element wywołujący działa na pierwszym planie. Połączenia z skutkuje odrzuceniem kodu SecurityException.

Parametry
sdkName String: nazwa pakietu SDK, który ma zostać wyładowany. Ta wartość nie może być typu null.

wyrejestrujAppPosiadanySdkSandboxInterface

public void unregisterAppOwnedSdkSandboxInterface (String name)

Wyrejestrowuje domenę ERROR(/AppOwnedSdkSandboxInterfaces) z procesu aplikacji.

Parametry
name String: nazwa, pod którą została zarejestrowana aplikacja AppOwnerSdkSandboxInterface. Ta wartość nie może być typu null.