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)class. Context có thể đến lượt lấy bằng SandboxedSdkProvider.getContext().

Tóm tắt

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<SandboxedSdkLoadSdkException> 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

Object clone()

Tạo và trả về một bản sao của đối tượng này.

boolean equals(Object obj)

Cho biết liệu một đối tượng nào đó khác có "bằng" đối tượng này hay không.

void finalize()

Được trình thu gom rác gọi trên một đối tượng khi tính năng thu thập rác xác định rằng không có tham chiếu nào khác đến đối tượng.

final Class<?> getClass()

Trả về lớp thời gian chạy của Object này.

int hashCode()

Trả về một giá trị mã băm cho đối tượng.

final void notify()

Đánh thức một luồng duy nhất đang chờ trên màn hình của đối tượng này.

final void notifyAll()

Đánh thức tất cả các luồng đang chờ trên màn hình của đối tượng này.

String toString()

Trả về một chuỗi đại diện của đối tượng.

final void wait(long timeoutMillis, int nanos)

Yêu cầu luồng hiện tại đợi cho đến khi được đánh thức (thường là khi có thông báo hoặc bị gián đoạn) hoặc cho đến khi một khoảng thời gian thực nhất định đã trôi qua.

final void wait(long timeoutMillis)

Yêu cầu luồng hiện tại đợi cho đến khi được đánh thức (thường là khi có thông báo hoặc bị gián đoạn) hoặc cho đến khi một khoảng thời gian thực nhất định đã trôi qua.

final void wait()

Yêu cầu luồng hiện tại phải đợi cho đến khi được đánh thức, thường là bằng cách thông báo hoặc gây gián đoạn.

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<SandboxedSdkLoadSdkException> 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.