# MediaBrowser.SubscriptionCallback

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# SubscriptionCallback

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/media/browse/MediaBrowser.SubscriptionCallback "View this page in Java")  

```
abstract class SubscriptionCallback
```

|---|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                                   ||
| ↳ | [android.media.browse.MediaBrowser.SubscriptionCallback](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.SubscriptionCallback#) |

Callbacks for subscription related events.

## Summary

|                                                                        Public constructors                                                                         ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [SubscriptionCallback](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.SubscriptionCallback#SubscriptionCallback())`()` <br /> |

|                                                                                                                                                                                                                                                                                                                                                                                              Public methods                                                                                                                                                                                                                                                                                                                                                                                              ||
|----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| open[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [onChildrenLoaded](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.SubscriptionCallback#onChildrenLoaded(kotlin.String,%20kotlin.collections.MutableList))`(`parentId:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`, `children:` `[MutableList](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)<[MediaBrowser.MediaItem](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.MediaItem)!>`)` Called when the list of children is loaded or updated.                                                                                                                     |
| open[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [onChildrenLoaded](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.SubscriptionCallback#onChildrenLoaded(kotlin.String,%20kotlin.collections.MutableList,%20android.os.Bundle))`(`parentId:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`, `children:` `[MutableList](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)<[MediaBrowser.MediaItem](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.MediaItem)!>`, `options:` `[Bundle](https://developer.android.com/reference/kotlin/android/os/Bundle.html#)`)` Called when the list of children is loaded or updated. |
| open[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [onError](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.SubscriptionCallback#onError(kotlin.String))`(`parentId:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`)` Called when the id doesn't exist or other errors in subscribing.                                                                                                                                                                                                                                                                                                                                                                                                             |
| open[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [onError](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.SubscriptionCallback#onError(kotlin.String,%20android.os.Bundle))`(`parentId:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`, `options:` `[Bundle](https://developer.android.com/reference/kotlin/android/os/Bundle.html#)`)` Called when the id doesn't exist or other errors in subscribing.                                                                                                                                                                                                                                                                                         |

## Public constructors

### SubscriptionCallback

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
SubscriptionCallback()
```

## Public methods

### onChildrenLoaded

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun onChildrenLoaded(
    parentId: String, 
    children: MutableList<MediaBrowser.MediaItem!>
): Unit
```

Called when the list of children is loaded or updated.

|                                                                                                                                                Parameters                                                                                                                                                ||
|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `parentId` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):The media id of the parent media item. This value cannot be`null`.                                                                                                                                          |
| `children` | [MutableList](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)\<[MediaBrowser.MediaItem](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.MediaItem)!\>:The children which were loaded. This value cannot be`null`. |

### onChildrenLoaded

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun onChildrenLoaded(
    parentId: String, 
    children: MutableList<MediaBrowser.MediaItem!>, 
    options: Bundle
): Unit
```

Called when the list of children is loaded or updated.

|                                                                                                                                                Parameters                                                                                                                                                ||
|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `parentId` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):The media id of the parent media item. This value cannot be`null`.                                                                                                                                          |
| `children` | [MutableList](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)\<[MediaBrowser.MediaItem](https://developer.android.com/reference/kotlin/android/media/browse/MediaBrowser.MediaItem)!\>:The children which were loaded. This value cannot be`null`. |
| `options`  | [Bundle](https://developer.android.com/reference/kotlin/android/os/Bundle.html#):The bundle of service-specific arguments sent to the media browser service. The contents of this bundle may affect the information returned when browsing. This value cannot be`null`.                      |

### onError

Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun onError(parentId: String): Unit
```

Called when the id doesn't exist or other errors in subscribing.

If this is called, the subscription remains until android.media.browse.MediaBrowser#unsubscribe called, because some errors may heal themselves.

|                                                                                             Parameters                                                                                             ||
|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `parentId` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):The media id of the parent media item whose children could not be loaded. This value cannot be`null`. |

### onError

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun onError(
    parentId: String, 
    options: Bundle
): Unit
```

Called when the id doesn't exist or other errors in subscribing.

If this is called, the subscription remains until android.media.browse.MediaBrowser#unsubscribe called, because some errors may heal themselves.

|                                                                                              Parameters                                                                                              ||
|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `parentId` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):The media id of the parent media item whose children could not be loaded. This value cannot be`null`.   |
| `options`  | [Bundle](https://developer.android.com/reference/kotlin/android/os/Bundle.html#):The bundle of service-specific arguments sent to the media browser service. This value cannot be`null`. |