# <GCKUIImagePicker> Protocol

[Instance Methods](https://developers.google.com/cast/docs/reference/ios/protocol_g_c_k_u_i_image_picker-p#pub-methods) \<GCKUIImagePicker\> Protocol Reference

## Overview

An object used for selecting an image for a given purpose from a [GCKMediaMetadata](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_metadata "A container for media metadata. ") object.

A default implementation is used internally by the framework which always selects the first image from the metadata for all uses. The application can provide a custom implementation by setting the [GCKCastContext::imagePicker](https://developers.google.com/cast/docs/reference/ios/category_g_c_k_cast_context_07_u_i_08#ada8e8d94275d23c230956e5146d19633 "The image picker implementation that will be used to select an image for a specific purpose...") property.

Since
:   3.0

Inherits \<NSObject\>.

|---|---|
| ## Instance Method Summary ||
| (nullable [GCKImage](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_image) \*) | - [getImageWithHints:fromMetadata:](https://developers.google.com/cast/docs/reference/ios/protocol_g_c_k_u_i_image_picker-p#ae99a4131372312a99342b24e8831c561) |
|   | Returns an image of the specified type from the media metadata. [More...](https://developers.google.com/cast/docs/reference/ios/protocol_g_c_k_u_i_image_picker-p#ae99a4131372312a99342b24e8831c561) |
|   ||

## Method Detail

|---|---|---|---|
| - (nullable [GCKImage](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_image) \*) getImageWithHints: |   | ([GCKUIImageHints](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_u_i_image_hints) \*) | *imageHints* |
| fromMetadata: |   | (const [GCKMediaMetadata](https://developers.google.com/cast/docs/reference/ios/interface_g_c_k_media_metadata) \*) | *metadata* |
|   |   |   |   |

Returns an image of the specified type from the media metadata.

Parameters
:

    |---|---|
    | imageHints | The hints about how to pick the image. |
    | metadata | The media metadata to pick from. |


Returns
:   The selected image, or `nil` if there is no appropriate image for the requested type.