# GCKMediaRequestItem Class

[Instance Methods](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#pub-methods) \| [Class Methods](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#pub-static-methods) \| [Properties](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#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:](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#ad8b33c8c262d4bef011fb8b7c8ff1b73) |
|   | Designated initializer. [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#ad8b33c8c262d4bef011fb8b7c8ff1b73) |
|   ||
| (instancetype) | - [initWithURL:protocolType:](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a150a306bfc882da7ee0fc815d98cb763) |
|   | Convenience initializer. [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a150a306bfc882da7ee0fc815d98cb763) |
|   ||

|---|---|
| ## Class Method Summary ||
| (NSString \*) | + [mapHLSSegmentFormatToString:](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a5dd3b24768b7de14feb2a41863081194) |
|   | Helper to convert from `GCKHLSSegmentFormat` to `NSString` [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a5dd3b24768b7de14feb2a41863081194) |
|   ||
| ([GCKHLSSegmentFormat](https://developers.google.com/cast/docs/reference/ios/g_c_k_h_l_s_segment_format_8h#a2e7a0fabbe01b583c51dab04d512642b)) | + [mapHLSSegmentFormatStringToEnum:](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#aaf905dc1693741ea952edaa83769ed6f) |
|   | Helper to convert from `NSString` to `GCKHLSSegmentFormat` [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#aaf905dc1693741ea952edaa83769ed6f) |
|   ||

|---|---|
| ## Property Summary ||
| NSURL \* | [mediaURL](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a865cd30fd05eff20ca918667c7ff815e) |
|   | The URL of media content. [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a865cd30fd05eff20ca918667c7ff815e) |
|   ||
| [GCKStreamingProtocolType](https://developers.google.com/cast/docs/reference/ios/g_c_k_media_request_item_8h#ad348a3b1c8767627b5be943796135fc2) | [protocolType](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a10b07711ef122b20f59623ea158bcbc1) |
|   | The media streaming protocol. [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a10b07711ef122b20f59623ea158bcbc1) |
|   ||
| NSTimeInterval | [initialTime](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a08a331626e1e252aad1db9590bed0931) |
|   | The initial time of media to precache. [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a08a331626e1e252aad1db9590bed0931) |
|   ||
| [GCKHLSSegmentFormat](https://developers.google.com/cast/docs/reference/ios/g_c_k_h_l_s_segment_format_8h#a2e7a0fabbe01b583c51dab04d512642b) | [hlsSegmentFormat](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a36164fc647e8998ff8e26f6c0192f68a) |
|   | The HLS segment format. [More...](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item#a36164fc647e8998ff8e26f6c0192f68a) |
|   ||

## Method Detail

|---|---|---|---|---|
| + (NSString \*) mapHLSSegmentFormatToString: |   | ([GCKHLSSegmentFormat](https://developers.google.com/cast/docs/reference/ios/g_c_k_h_l_s_segment_format_8h#a2e7a0fabbe01b583c51dab04d512642b)) | *hlsSegmentFormat* |   |

Helper to convert from `GCKHLSSegmentFormat` to `NSString`

Since
:   4.1

|---|---|---|---|---|
| + ([GCKHLSSegmentFormat](https://developers.google.com/cast/docs/reference/ios/g_c_k_h_l_s_segment_format_8h#a2e7a0fabbe01b583c51dab04d512642b)) mapHLSSegmentFormatStringToEnum: |   | (NSString \*) | *hlsSegmentFormatString* |   |

Helper to convert from `NSString` to `GCKHLSSegmentFormat`

Since
:   4.1

|---|---|---|---|
| - (instancetype) initWithURL: |   | (NSURL \*) | *url* |
| protocolType: |   | ([GCKStreamingProtocolType](https://developers.google.com/cast/docs/reference/ios/g_c_k_media_request_item_8h#ad348a3b1c8767627b5be943796135fc2)) | *protocolType* |
| initialTime: |   | (NSTimeInterval) | *initialTime* |
| hlsSegmentFormat: |   | ([GCKHLSSegmentFormat](https://developers.google.com/cast/docs/reference/ios/g_c_k_h_l_s_segment_format_8h#a2e7a0fabbe01b583c51dab04d512642b)) | *hlsSegmentFormat* |
|   |   |   |   |

Designated initializer.

Initializes a [GCKMediaRequestItem](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item "A class representing a request item sent to Cast receivers. ") with URL, protocol type, initial time, and HLS segment type.

|---|---|---|---|
| - (instancetype) initWithURL: |   | (NSURL \*) | *url* |
| protocolType: |   | ([GCKStreamingProtocolType](https://developers.google.com/cast/docs/reference/ios/g_c_k_media_request_item_8h#ad348a3b1c8767627b5be943796135fc2)) | *protocolType* |
|   |   |   |   |

Convenience initializer.

Initializes a [GCKMediaRequestItem](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_request_item "A class representing a request item sent to Cast receivers. ") with URL and protocol type and use default values for other properties.

## Property Detail

|---|---|
| |---| | - (NSURL\*) mediaURL | | readwritenonatomicstrong |

The URL of media content.

|---|---|
| |---| | - ([GCKStreamingProtocolType](https://developers.google.com/cast/docs/reference/ios/g_c_k_media_request_item_8h#ad348a3b1c8767627b5be943796135fc2)) protocolType | | readwritenonatomicassign |

The media streaming protocol.

|---|---|
| |---| | - (NSTimeInterval) initialTime | | readwritenonatomicassign |

The initial time of media to precache.

The default is 0.0.

|---|---|
| |---| | - ([GCKHLSSegmentFormat](https://developers.google.com/cast/docs/reference/ios/g_c_k_h_l_s_segment_format_8h#a2e7a0fabbe01b583c51dab04d512642b)) hlsSegmentFormat | | readwritenonatomicassign |

The HLS segment format.

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