Skip to main content
Version: 20 Mar 2024

MLMediaDRMEventCallbacks

Module: Media Player

Callbacks for notifying client about MLMediaDRM events. More...

#include <ml_media_drm.h>

Public Attributes

TypeName
uint32_tversion
void()(MLHandle media_drm, const MLMediaDRMEventInfo event_info)on_event
This callback function is invoked when specific MLMediaDrm events happen.
void()(MLHandle media_drm, const MLMediaDRMExpirationUpdateInfo update_info)on_expiration_update
This callback function is invoked when a drm session expiration update occurs.
void()(MLHandle media_drm, const MLMediaDRMKeyStatusInfo key_status_info)on_key_status_change
This callback function is invoked when the keys in a drm session change states.

Detailed Description

struct MLMediaDRMEventCallbacks;

Callbacks for notifying client about MLMediaDRM events.

User of MLMediaDRM should implement this.

Deprecated

Deprecated since 1.4.0. Scheduled for removal.

API Level:

  • 20

Public Attributes Documentation

version

uint32_t version;

Version of this structure.


on_event

void(*)(MLHandle media_drm, const MLMediaDRMEventInfo *event_info) on_event;

This callback function is invoked when specific MLMediaDrm events happen.

TypeDescription
void()(MLHandle media_drm, const MLMediaDRMEventInfo event_info))(MLHandle media_drm, const MLMediaDRMEventInfo *event_info)

Parameters

media_drmMediaDRM instance on which callback was set.
event_infoMediaDRM info as MLMediaDRMEventInfo.

on_expiration_update

void(*)(MLHandle media_drm, const MLMediaDRMExpirationUpdateInfo *update_info) on_expiration_update;

This callback function is invoked when a drm session expiration update occurs.

TypeDescription
void()(MLHandle media_drm, const MLMediaDRMExpirationUpdateInfo update_info))(MLHandle media_drm, const MLMediaDRMExpirationUpdateInfo *update_info)

Parameters

media_drmMediaDRM instance on which callback was set.
update_infoUpdated session info as MLMediaDRMEventInfo.

If this callback is not defined, then MLMediaDRMEventType_ExpirationUpdate event is notified through on_event callback, without the expiration time.


on_key_status_change

void(*)(MLHandle media_drm, const MLMediaDRMKeyStatusInfo *key_status_info) on_key_status_change;

This callback function is invoked when the keys in a drm session change states.

TypeDescription
void()(MLHandle media_drm, const MLMediaDRMKeyStatusInfo key_status_info))(MLHandle media_drm, const MLMediaDRMKeyStatusInfo *key_status_info)

Parameters

media_drmMediaDRM instance on which callback was set.
key_status_infoChanged key status as MLMediaDRMKeyStatusInfo.

If this callback is not defined, then MLMediaDRMEventType_KeysChange event is notified through on_event callback, without the key(s) status information.