이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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`일 수 없습니다.