SdkSandboxController

public class SdkSandboxController
extends Object

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

Bộ điều khiển mà SDK dùng, được tải vào hộp cát để truy cập vào thông tin do SDK cung cấp hộp cát.

Điều này cho phép SDK giao tiếp với các SDK khác trong hộp cát SDK và biết về trạng thái của sdks hiện được tải trong đó.

Bạn có thể lấy một thực thể của SdkSandboxController bằng cách sử dụng Context.getSystemService(Class) và class. Context có thể đến lượt lấy bằng SandboxedSdkProvider.getContext().

Tóm tắt

Các hằng số

String SDK_SANDBOX_CONTROLLER_SERVICE

Phương thức công khai

List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces()

Tìm nạp tất cả AppOwnedSdkSandboxInterface mà ứng dụng đã đăng ký.

String getClientPackageName()

Trả về tên gói của ứng dụng.

SharedPreferences getClientSharedPreferences()

Trả về SharedPreferences chứa dữ liệu đã đồng bộ hoá từ ứng dụng.

List<SandboxedSdk> getSandboxedSdks()

Tìm nạp thông tin về SDK đã tải trong hộp cát.

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

Tải SDK trong quy trình java hộp cát SDK.

IBinder registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Trả về giá trị nhận dạng của SdkSandboxActivityHandler sau khi đăng ký.

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Huỷ đăng ký một SdkSandboxActivityHandler đã đăng ký.

Các phương thức kế thừa

Hằng số

DỊCH_ VỤ_SDK_SAND_BOX_CONTROLLER_

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 5 
public static final String SDK_SANDBOX_CONTROLLER_SERVICE

Giá trị không đổi: "sdk_sandbox_controller_service"

Phương thức công khai

getAppOwnedSdkSandboxInterfaces

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Tìm nạp tất cả AppOwnedSdkSandboxInterface mà ứng dụng đã đăng ký.

Giá trị trả về
List<AppOwnedSdkSandboxInterface> Danh sách AppOwnedSdkSandboxInterface chứa tất cả những người hiện đang đăng ký AppOwnedSdkSandboxInterface. Giá trị này không được là null.
Gửi
UnsupportedOperationException nếu bộ điều khiển được lấy từ một ngữ cảnh. Sử dụng SandboxedSdkProvider#getContext() cho ngữ cảnh phù hợp

getClientPackageName

public String getClientPackageName ()

Trả về tên gói của ứng dụng.

Giá trị trả về
String Giá trị này không được là null.
Gửi
UnsupportedOperationException nếu bộ điều khiển được lấy từ một ngữ cảnh. Sử dụng SandboxedSdkProvider#getContext() cho ngữ cảnh phù hợp.

getClientSharedPreferences

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 5 
public SharedPreferences getClientSharedPreferences ()

Trả về SharedPreferences chứa dữ liệu đã đồng bộ hoá từ ứng dụng.

Bạn có thể tìm thấy các khoá đã được ứng dụng khách đồng bộ hoá bằng SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) trong SharedPreferences này.

SharedPreferences được trả về chỉ được đọc. Viết vào thư viện thì không được hỗ trợ.

Giá trị trả về
SharedPreferences SharedPreferences chứa dữ liệu đã đồng bộ hoá từ ứng dụng khách. Giá trị này không được là null.
Gửi
UnsupportedOperationException nếu bộ điều khiển được lấy từ một ngữ cảnh. Sử dụng SandboxedSdkProvider#getContext() cho ngữ cảnh phù hợp

getSandboxedSdk

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 5 
public List<SandboxedSdk> getSandboxedSdks ()

Tìm nạp thông tin về SDK đã tải trong hộp cát.

Giá trị trả về
List<SandboxedSdk> Danh sách SandboxedSdk chứa tất cả SDK hiện đang tải Giá trị này không được là null.
Gửi
UnsupportedOperationException nếu bộ điều khiển được lấy từ một ngữ cảnh. Sử dụng SandboxedSdkProvider#getContext() cho ngữ cảnh phù hợp

tải Sdk

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

Tải SDK trong quy trình java hộp cát SDK.

Tải thư viện SDK có sdkName vào quy trình hộp cát SDK theo cách không đồng bộ. Chiến lược phát hành đĩa đơn người gọi sẽ được thông báo qua receiver.

Phương thức gọi chỉ có thể tải SDKs mà ứng dụng khách phụ thuộc vào hộp cát SDK.

Tham số
sdkName String: tên của SDK cần tải. Giá trị này không được là null.
params Bundle: các tham số bổ sung sẽ được truyền đến SDK ở dạng Bundle theo thoả thuận giữa ứng dụng và SDK. Giá trị này không được là null.
executor Executor: Executor để gọi trình nhận. Giá trị này không được là null. Các sự kiện gọi lại và trình nghe được gửi đi thông qua Executor này, giúp bạn dễ dàng kiểm soát chuỗi nào được sử dụng. Để gửi thông báo các sự kiện thông qua chuỗi chính trong ứng dụng, bạn có thể sử dụng Context.getMainExecutor(). Nếu không, hãy cung cấp Executor để gửi đến một luồng phù hợp.
receiver OutcomeReceiver: Hàm này sẽ nhận được SandboxedSdk khi chạy thành công hoặc LoadSdkException. Giá trị này không được là null.
Gửi
UnsupportedOperationException nếu bộ điều khiển được lấy từ một ngữ cảnh. Sử dụng SandboxedSdkProvider#getContext() cho ngữ cảnh phù hợp

Đăng kýSdkSandboxActivityHandler

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 7 
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Trả về giá trị nhận dạng của SdkSandboxActivityHandler sau khi đăng ký.

Hàm này đăng ký triển khai SdkSandboxActivityHandler được tạo bởi một SDK và trả về một IBinder xác định duy nhất đối tượng SdkSandboxActivityHandler đã truyền.

Nếu cùng một SdkSandboxActivityHandler được đăng ký nhiều lần mà không nếu bạn huỷ đăng ký, thì hệ thống sẽ trả về cùng một mã thông báo IBinder.

Tham số
sdkSandboxActivityHandler SdkSandboxActivityHandler: là SdkSandboxActivityHandler để đăng ký. Giá trị này không được là null.
Giá trị trả về
IBinder IBinder chỉ xác định duy nhất SdkSandboxActivityHandler đã truyền. Giá trị này không được là null.

huỷ đăng kýSdkSandboxActivityHandler

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 7 
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Huỷ đăng ký một SdkSandboxActivityHandler đã đăng ký.

Nếu đã đăng ký, SdkSandboxActivityHandler đã thông qua sẽ bị huỷ đăng ký. Nếu không, tính năng này sẽ không làm gì cả.

Sau khi huỷ đăng ký, SDK có thể đăng ký lại cùng một đối tượng trình xử lý hoặc tạo một đối tượng mới trong trong trường hợp muốn có Activity mới.

Nếu mã thông báo IBinder của trình xử lý chưa đăng ký được dùng để bắt đầu một Activity, Activity sẽ không khởi động được.

Tham số
sdkSandboxActivityHandler SdkSandboxActivityHandler: là SdkSandboxActivityHandler cần huỷ đăng ký. Giá trị này không được là null.
Trả về
void Giá trị này không được là null.