RootSourceClient
SourceClient specialization for showing the content of the root of a media source's browsing hierarchy. It provides access to a source's categories (the top-level items used to access all available content), and can be instructed to browse through any of the available content.
If no custom media item is initially browsed to via browseTo, the contents of the first available category will be made available automatically.
Parameters
Android context.
ID of the source to connect to.
The coroutine dispatcher to use to launch background operations. The most common are IPC requests via Binder. Defaults to the IO dispatcher.
Properties
List of available top-level categories for this source. The categories could be updated over time if the source decides to do so.
The list of IviMediaItems contained in the subscribed mediaItem. Initially empty. The contents will be updated over time if the source decides to do so.
Whether the source can be queried and provide content.
The IviMediaItem currently subscribed to. Initially empty. Can be changed to subscribe to different contents. If not changed, the client will set it to a default item: the first available category.
The client root extras. Can be used to store various values to determine source behavior.
Functions
Load and subscribe to a new media item. The mediaItem will first be updated with the newMediaItem, then the contents will be updated with its child items. It is not necessary for the client to be connected already. This method can be called on creation to initially browse to the specified newMediaItem instead of the default.
Launch a browser action.
Connects client to a media source to display the content. The connection is kept until disconnect is called.
Disconnects client from a media source and clears the content.
Set the callback where to receive notifications about error conditions.