12 UE Media Session Handling (M6) APIs for uplink and downlink
26.5123GPP5G Media Streaming (5GMS)ProtocolsRelease 17TS
12.1 General
This clause defines the client APIs for Media Session Handling to be used by other 5G System components such as a Media Player in a 5GMSd Client or the Media Streamer in a 5GMSu Client.
NOTE: Client-driven management of edge processing resources via reference point M6 is not specified in this release.
12.2 Media Session Handling for Downlink media streaming – APIs and Functions
12.2.1 Overview
In the following, it is assumed that the Media Session Handler for downlink media streaming adheres to a basic set of functionalities as shown in Figure 12.2.1-1.
Figure 12.2.1-1: Usage of M6d in Media Downlink Streaming
The Media Session Handler is considered to run as a service in the background, and is invoked for a media session once a media player in the 5GMSd streaming client is activated with an MPD URL of media MIME type "application/dash+xml". Based on the MPD URL, the Media Session Handler may initiate communication with the 5GMSd AF through M5d.
NOTE: The initiation of the Media Session Handler for other media types than DASH is for further study.
For an ongoing 5G Media Streaming session, the Media Session Handler is given the following authorizations:
1) The ability to do status query on M7d. For details see clause 13.
2) The ability to process notifications and error on M7d. For details see clause 13.
3) The ability to configure certain parameters on the media player based on M7d. For details again see clause 13.
In addition, the MSH can provide information on M6d to the application and possibly delegated to Media Player using M6d for each of the Media Session Handler functionalities, namely providing:
1) Notification and Error Events;
2) Status Information.
12.2.2 Media Session Handler model
12.2.2.1 State model
An informative state model for the Media Session Handler is for further study.
12.2.2.2 Media Session Handler internal properties
The Media Session Handler maintains internal properties as defined Table 12.2.2.2-1. Note that the parameters are conceptual and internal and only serve for the purpose to describe message generation on the API calls.
Table 12.2.2.2-1: Parameters of Media Session Handler
|
States and Parameters |
Definition |
||
|
_Configuration |
|||
|
_networkAssistance |
Network Assistance configuration. |
||
|
_policyTemplate |
Policy Template configuration. |
||
|
_consumptionReporting |
Consumption reporting configuration. |
||
|
_metricsReporting |
Metrics reporting configuration. |
||
|
_status[] |
The Media Session Handler maintains a status record. |
||
12.2.2.3 Media Session Handler internal operations
This aspect is for further study.
12.2.2.4 Starting and Stopping a Media Session Handler
There are different ways to start a Media Session Handler. The most typical one is that the start is bound to the call of a Media Player with an MPD URL. That start method offers a client–server like interface realized by M6d. The service is bound such that the Media Session Handler communicates back to the Media Player.
12.2.3 General
Table 12.2.3-1 provides a list status information that can be obtained from the Media Session Handler through M6d.
Table 12.2.3-1: Status Information
|
Status |
Type |
Parameter |
Definition |
Table 12.2.3-2 provides a list of general notification events exposed on M6d.
Table 12.2.3-2: General Notification Events
|
Event |
Definition |
Payload |
|
SESSION_HANDLING_ACTIVATED |
Triggered when media session handling was activated for a specific MPD URL. |
|
|
SESSION_HANDLING_STOPPED |
Triggered when media session handling stopped for a specific MPD URL. |
Table 12.2.3-3 provides a list of general error events through M6d.
Table 12.2.3-3: General Error Events
|
Status |
Definition |
Payload |
|
ERROR_SESSION_HANDLING |
Triggered when there is an error in the media session handling. |
Not applicable. |
12.2.4 Dynamic Policy Information
Details are for further study.
12.2.5 Network Assistance Information
Details are for further study.
12.2.6 Consumption Reporting Information
Table 12.2.6-1 provides a list status information that can be obtained from the MSH through M6d.
Table 12.2.6-1: Status Information related to Consumption Reporting
|
Status |
Type |
Parameter |
Definition |
|
consumptionReport |
Object |
The latest sent consumption report. |
Table 12.2.6-2 provides a list of general notification events exposed on M6d.
Table 12.2.6-2: Notification Events related to Consumption Reporting
|
Status |
Definition |
Payload |
|
CONSUMPTION_REPORTING_ACTIVATED |
Informs that consumption reporting has been activated. |
Not applicable. |
|
CONSUMPTION_REPORTING_STOPPED |
Informs that consumption reporting has been stopped. |
Not applicable. |
|
NEW_CONSUMPTION_REPORT |
Informs that a new consumption report is available and has been sent. |
Table 12.2.6-3 provides a list of general error events through M6d.
Table 12.2.6-3: Error Events to Consumption Reporting
|
Status |
Definition |
Payload |
|
ERROR_CONSUMPTION_REPORTING |
Error in consumption reporting occurred. |
Not applicable. |
12.2.7 Metrics Reporting Information
Details are for further study.
12.3 Media Session Handling for Uplink Streaming – APIs and Functions
Details are for further study.