API 수준 34에 추가됨
광고 서비스 확장 프로그램 5에도 추가됨

요약: 상수 | 메서드 | 상속된 메서드

SdkSandboxController

public class SdkSandboxController
extends Object

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

---

샌드박스에 로드된 SDK에서 사용하여 SDK에서 제공하는 정보에 액세스하는 컨트롤러 있습니다.

이를 통해 SDK가 SDK 샌드박스의 다른 SDK와 통신하고 상태를 파악할 수 있습니다. 현재 로드되어 있는 SDK의 근사치를 확인할 수 있습니다

SdkSandboxController 인스턴스는 Context.getSystemService(Class) 및 class를 사용하여 얻을 수 있습니다. Context는 SandboxedSdkProvider.getContext()를 사용하여 얻습니다.

요약

상수
String	SDK_SANDBOX_CONTROLLER_SERVICE

공개 메서드
List<AppOwnedSdkSandboxInterface>	getAppOwnedSdkSandboxInterfaces() 앱에 등록된 모든 AppOwnedSdkSandboxInterface를 가져옵니다.
String	getClientPackageName() 클라이언트 앱의 패키지 이름을 반환합니다.
SharedPreferences	getClientSharedPreferences() 클라이언트 앱에서 동기화된 데이터가 포함된 SharedPreferences를 반환합니다.
List<SandboxedSdk>	getSandboxedSdks() 샌드박스에 로드된 SDK에 대한 정보를 가져옵니다.
void	loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver) SDK 샌드박스 자바 프로세스에서 SDK를 로드합니다.
IBinder	registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler) SdkSandboxActivityHandler를 등록한 후 식별자를 반환합니다.
void	unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler) 이미 등록된 SdkSandboxActivityHandler를 등록 취소합니다.

상속된 메서드

java.lang.Object 클래스에서 상속 Object clone() 이 개체의 사본을 만들어 반환합니다. boolean equals(Object obj) 일부 다른 개체가 이 개체와 '같은'지 여부를 나타냅니다. void finalize() 가비지 컬렉션이 더 이상 객체에 관한 참조가 없다고 판단하는 경우 객체의 가비지 컬렉터에서 호출합니다. final Class<?> getClass() 이 Object의 런타임 클래스를 반환합니다. int hashCode() 객체의 해시 코드 값을 반환합니다. final void notify() 이 객체의 모니터에서 대기 중인 단일 스레드의 대기 모드를 해제합니다. final void notifyAll() 이 개체의 모니터에서 대기 중인 모든 스레드의 대기 모드를 해제합니다. String toString() 객체의 문자열 표현을 반환합니다. final void wait(long timeoutMillis, int nanos) 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 또는 일정 시간이 경과할 때까지 현재 스레드가 대기하도록 합니다. final void wait(long timeoutMillis) 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 또는 일정 시간이 경과할 때까지 현재 스레드가 대기하도록 합니다. final void wait() 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 현재 스레드가 대기하도록 합니다.

상수

SDK_SANDBOX_CONTROLLER_SERVICE

API 수준 34에 추가됨
광고 서비스 확장 프로그램 5에도 추가됨

public static final String SDK_SANDBOX_CONTROLLER_SERVICE

상수 값: 'sdk_sandbox_controller_service'

공개 메서드

getAppOwnedSdkSandboxInterfaces

Android UpsideDownCakePrivacySandbox에 추가됨

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

앱에 등록된 모든 AppOwnedSdkSandboxInterface를 가져옵니다.

반환 값
List<AppOwnedSdkSandboxInterface>	현재 등록된 모든 항목을 포함하는 AppOwnedSdkSandboxInterface 목록 AppOwnedSdkSandboxInterface입니다. 이 값은 null일 수 없습니다.

생성 값
UnsupportedOperationException	컨트롤러가 예기치 않은 있습니다. 적절한 컨텍스트에 SandboxedSdkProvider#getContext() 사용

getClientPackageName

Android UpsideDownCakePrivacySandbox에 추가됨

public String getClientPackageName ()

클라이언트 앱의 패키지 이름을 반환합니다.

반환 값
String	이 값은 null일 수 없습니다.

생성 값
UnsupportedOperationException	컨트롤러가 예기치 않은 있습니다. 올바른 컨텍스트에 SandboxedSdkProvider#getContext()를 사용합니다.

getClientSharedPreferences

API 수준 34에 추가됨
광고 서비스 확장 프로그램 5에도 추가됨

public SharedPreferences getClientSharedPreferences ()

클라이언트 앱에서 동기화된 데이터가 포함된 SharedPreferences를 반환합니다.

SdkSandboxManager.addSyncedSharedPreferencesKeys(Set)를 사용하여 클라이언트 앱에서 동기화한 키는 이 SharedPreferences에서 확인할 수 있습니다.

반환된 SharedPreferences는 읽을 수만 있어야 합니다. 여기에 쓰는 것은 지원됩니다.

반환 값
SharedPreferences	클라이언트 앱에서 동기화된 데이터가 포함된 SharedPreferences 이 값은 null일 수 없습니다.

생성 값
UnsupportedOperationException	컨트롤러가 예기치 않은 있습니다. 적절한 컨텍스트에 SandboxedSdkProvider#getContext() 사용

getSandboxedSdks

API 수준 34에 추가됨
광고 서비스 확장 프로그램 5에도 추가됨

public List<SandboxedSdk> getSandboxedSdks ()

샌드박스에 로드된 SDK에 대한 정보를 가져옵니다.

반환 값
List<SandboxedSdk>	현재 로드된 모든 SDK가 포함된 SandboxedSdk 목록 이 값은 null일 수 없습니다.

생성 값
UnsupportedOperationException	컨트롤러가 예기치 않은 있습니다. 적절한 컨텍스트에 SandboxedSdkProvider#getContext() 사용

loadSdk

Android UpsideDownCakePrivacySandbox에 추가됨

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

SDK 샌드박스 자바 프로세스에서 SDK를 로드합니다.

sdkName를 사용하여 SDK 라이브러리를 SDK 샌드박스 프로세스에 비동기식으로 로드합니다. 이 receiver를 통해 알림이 전송됩니다.

호출자는 클라이언트 앱이 의존하는 SDKs만 SDK 샌드박스에 로드할 수 있습니다.

매개변수
sdkName	String: 로드할 SDK의 이름입니다. 이 값은 null일 수 없습니다.
params	Bundle: Bundle 형식으로 SDK에 전달할 추가 매개변수입니다. 계약된 계약 조항을 따릅니다. 이 값은 null일 수 없습니다.
executor	Executor: 수신자를 호출할 Executor입니다. 이 값은 null일 수 없습니다. 콜백 및 리스너 이벤트는 이 Executor를 통해 전달되므로 사용되는 스레드를 쉽게 제어할 수 있습니다. 애플리케이션의 기본 스레드를 통해 이벤트를 전달하려면 Context.getMainExecutor()를 사용하면 됩니다. 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
receiver	OutcomeReceiver: 성공한 실행 시 SandboxedSdk를 수신하거나 LoadSdkException를 수신합니다. 이 값은 null일 수 없습니다.

생성 값
UnsupportedOperationException	컨트롤러가 예기치 않은 있습니다. 적절한 컨텍스트에 SandboxedSdkProvider#getContext() 사용

registerSdkSandboxActivityHandler

API 수준 34에 추가됨
광고 서비스 확장 프로그램 7에도 추가됨

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

SdkSandboxActivityHandler를 등록한 후 식별자를 반환합니다.

이 함수는 다음을 통해 만든 SdkSandboxActivityHandler의 구현을 등록합니다. SDK를 호출하고 전달된 SdkSandboxActivityHandler 객체를 고유하게 식별하는 IBinder를 반환합니다.

동일한 SdkSandboxActivityHandler가 등록을 취소하면 동일한 IBinder 토큰이 반환됩니다.

매개변수
sdkSandboxActivityHandler	SdkSandboxActivityHandler: 등록할 SdkSandboxActivityHandler입니다. 이 값은 null일 수 없습니다.

반환 값
IBinder	IBinder는 전달된 SdkSandboxActivityHandler를 고유하게 식별합니다. 이 값은 null일 수 없습니다.

unregisterSdkSandboxActivityHandler

API 수준 34에 추가됨
광고 서비스 확장 프로그램 7에도 추가됨

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

이미 등록된 SdkSandboxActivityHandler를 등록 취소합니다.

전달된 SdkSandboxActivityHandler가 등록되면 등록이 취소됩니다. 그렇지 않으면 아무 작업도 하지 않습니다.

등록 취소 후 SDK는 동일한 핸들러 객체를 다시 등록하거나 다음 위치에서 새 핸들러 객체를 만들 수 있습니다. 새로운 Activity를 원합니다.

등록되지 않은 핸들러의 IBinder 토큰이 Activity를 시작하는 데 사용된 경우 Activity가 시작되지 않습니다.

매개변수
sdkSandboxActivityHandler	SdkSandboxActivityHandler: 등록 취소할 SdkSandboxActivityHandler입니다. 이 값은 null일 수 없습니다.

반환 값
void	이 값은 null일 수 없습니다.