GCKMediaRequestItem Class

  • The GCKMediaRequestItem class represents a request to precache or stream media content on Cast receivers.

  • It provides methods for initializing request items with media URLs, protocols, and initial playback times.

  • Helper methods are available to convert between GCKHLSSegmentFormat and NSString representations.

  • Key properties include mediaURL, protocolType, initialTime, and hlsSegmentFormat for customizing media requests.

  • Introduced in version 4.0, this class inherits from NSObject, NSCopying, and NSSecureCoding.
Instance Methods | Class Methods | Properties
GCKMediaRequestItem Class Reference

Overview

A class representing a request item sent to Cast receivers.

It can be used for precaching media contents.

Since
4.0

Inherits NSObject, <NSCopying>, and <NSSecureCoding>.

Instance Method Summary

(instancetype) - initWithURL:protocolType:initialTime:hlsSegmentFormat:
 Designated initializer. More...
 
(instancetype) - initWithURL:protocolType:
 Convenience initializer. More...
 

Class Method Summary

(NSString *) + mapHLSSegmentFormatToString:
 Helper to convert from GCKHLSSegmentFormat to NSString More...
 
(GCKHLSSegmentFormat) + mapHLSSegmentFormatStringToEnum:
 Helper to convert from NSString to GCKHLSSegmentFormat More...
 

Property Summary

NSURL * mediaURL
 The URL of media content. More...
 
GCKStreamingProtocolType protocolType
 The media streaming protocol. More...
 
NSTimeInterval initialTime
 The initial time of media to precache. More...
 
GCKHLSSegmentFormat hlsSegmentFormat
 The HLS segment format. More...
 

Method Detail

+ (NSString *) mapHLSSegmentFormatToString: (GCKHLSSegmentFormat)  hlsSegmentFormat

Helper to convert from GCKHLSSegmentFormat to NSString

Since
4.1
+ (GCKHLSSegmentFormat) mapHLSSegmentFormatStringToEnum: (NSString *)  hlsSegmentFormatString

Helper to convert from NSString to GCKHLSSegmentFormat

Since
4.1
- (instancetype) initWithURL: (NSURL *)  url
protocolType: (GCKStreamingProtocolType)  protocolType
initialTime: (NSTimeInterval)  initialTime
hlsSegmentFormat: (GCKHLSSegmentFormat)  hlsSegmentFormat 

Designated initializer.

Initializes a GCKMediaRequestItem with URL, protocol type, initial time, and HLS segment type.

- (instancetype) initWithURL: (NSURL *)  url
protocolType: (GCKStreamingProtocolType)  protocolType 

Convenience initializer.

Initializes a GCKMediaRequestItem with URL and protocol type and use default values for other properties.

Property Detail

- (NSURL*) mediaURL
readwritenonatomicstrong

The URL of media content.

- (GCKStreamingProtocolType) protocolType
readwritenonatomicassign

The media streaming protocol.

- (NSTimeInterval) initialTime
readwritenonatomicassign

The initial time of media to precache.

The default is 0.0.

- (GCKHLSSegmentFormat) hlsSegmentFormat
readwritenonatomicassign

The HLS segment format.

It's required if protocolType == GCKStreamingProtocolTypeHLS. The default is GCKHLSSegmentFormatUndefined.