DelegatingSandboxedUiAdapter
@ExperimentalFeatures.DelegatingAdapterApi
class DelegatingSandboxedUiAdapter : SandboxedUiAdapter
A SandboxedUiAdapter that helps delegate calls to other uiAdapters.
When this adapter is set to the client's container, the adapter can switch the delegate uiAdapter, that serves the Session, without involving the client. For each new delegate, a session would be requested with all clients of this adapter.
One example use-case of these kind of UIAdapters is to support updating the provider of the UI without the client's involvement.
Summary
Nested types |
|---|
|
Listener that consumes events to process the delegate change for a client |
Public constructors |
|---|
DelegatingSandboxedUiAdapter(delegate: Bundle) |
Public functions |
|
|---|---|
Unit |
|
Bundle |
Fetches the current delegate which is a |
open Unit |
openSession(Open a new session for displaying content with an initial size of |
Unit |
|
suspend Unit |
updateDelegate(delegate: Bundle)Updates the delegate and notifies all listeners to process the update. |
Public constructors
Public functions
addDelegateChangeListener
fun addDelegateChangeListener(
listener: DelegatingSandboxedUiAdapter.DelegateChangeListener
): Unit
getDelegate
fun getDelegate(): Bundle
Fetches the current delegate which is a SandboxedUiAdapter Bundle.
openSession
open fun openSession(
context: Context,
sessionConstants: SessionConstants,
initialWidth: Int,
initialHeight: Int,
isZOrderOnTop: Boolean,
clientExecutor: Executor,
client: SandboxedUiAdapter.SessionClient
): Unit
Open a new session for displaying content with an initial size of initialWidthxinitialHeight pixels. client will receive all incoming communication from the provider of content. All incoming calls to client will be made through the provided clientExecutor. isZOrderOnTop tracks if the content surface will be placed on top of its window
removeDelegateChangeListener
fun removeDelegateChangeListener(
listener: DelegatingSandboxedUiAdapter.DelegateChangeListener
): Unit
updateDelegate
suspend fun updateDelegate(delegate: Bundle): Unit
Updates the delegate and notifies all listeners to process the update. If any listener fails process refresh we throw IllegalStateException. Cancellation of this API does not propagate to the client side.