This subclause specifies the open media to start the reception of a given media delivered over an MBMS subchannel.
With this API function, header decompression and FEC decoding can be performed by the MC MBMS user agent or by the MC application.
This API function allows two methods to return the media from the MC MBMS user agent to the MC application: by providing them on a local network interface or by returning them with a callback mechanism.
The procedure specified in Figure 5.11.2-1 allows the consumption of a media delivered over MBMS.
Pre-conditions:
The MC application is registered towards the MC MBMS user agent
A MBMS bearer has been announced to the MC application through the MBMS procedures specified in TS 23.280 and registered toward the MC MBMS user agent.
This MBMS bearer is available within the UE location.
The MC application asks to access to the communication with the open media request, by indicating the TMGI of the MBMS bearer and a list of media description information. If the MC application requests FEC decoding and/or header decompression, relevant FEC and ROHC information are included within the open media request; if the MC application wants the media packets to be returned by callback, the MC application provides a callback listener.
When the media is available, the MC MBMS user agent sends an open media response to the MC application, including a description of the required media (which can be with or without FEC decoding). If packets are returned to the MC application through a local network interface, this network interface name is included in the response.
The MC MBMS user agent makes the media streams available to the MC application according to the configured method for returning media with a help of a local network interface, or by returning the media packets to the callback listener provided in step 1.
Post-conditions:
The MC application can consume the required media, until interruption if the MBMS bearer becomes unavailable, or until it closes the media with the close media procedure.
Describes the multicast IP adresses and ports of the requested media. (e.g. the MBMS subchannel)
FEC information
O
FEC information if the MC application requests the MC MBMS user agent to perform the FEC decoding
ROHC information
O
ROHC information for the requested media. Indicates if header decompression by the MC MBMS user agent is requested
Callback
O
Dedicated callback listener where to return the received media packets. If this IE is not present, the media packets are returned over a local network interface
Indicates if the open media request was successful, otherwise an error code
Message
O
Additional details
Media description
O
Description of opened media, including the multicast IP address and port of the media, after FEC decoding
Network interface
O
The local network interface, identified by the name of a network interface card, where the given media can be consumed by the MC application, if packet are forwarded to the MC application over a local network interface according the configured method for media reception
Figure 5.12.2-1 illustrates the procedure for close media.
Pre-conditions:
The MC application is consuming a media, after having called the open media procedure.
The MC application has received a UnMapGroupToBearer message (see TS 23.379, table 10.10.1.2 -1 for MCPTT and TS 23.281, table 7.10.1.3-1 for MCVideo).
This subclause defines API function of retrieve capability.
The retrieve capability request is an API function call and retrieve capability response is returned with a list of capabilities.
The MC application uses this API function call to query what capabilities (e.g. FEC and ROHC) are supported by the MC MBMS user agent.