Protocole <GCKUIImagePicker>
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Objet utilisé pour sélectionner une image dans un objet GCKMediaMetadata dans un but précis.
Une implémentation par défaut est utilisée en interne par le framework qui sélectionne toujours la première image parmi les métadonnées pour toutes les utilisations. L'application peut fournir une implémentation personnalisée en définissant la propriété GCKCastContext::imagePicker.
- Depuis
- 3,0
Hérite de <NSObject>.
Renvoie une image du type spécifié à partir des métadonnées multimédias.
- Parameters
-
| imageHints | The hints about how to pick the image. |
| metadata | The media metadata to pick from. |
- Renvoie
- Image sélectionnée, ou
nil si aucune image ne correspond au type demandé.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eGCKUIImagePicker\u003c/code\u003e protocol helps select images from \u003ccode\u003eGCKMediaMetadata\u003c/code\u003e objects for display within the Google Cast framework.\u003c/p\u003e\n"],["\u003cp\u003eBy default, the first image in the metadata is used, but apps can customize image selection via \u003ccode\u003eGCKCastContext::imagePicker\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetImageWithHints:fromMetadata:\u003c/code\u003e method fetches a specific image type from the metadata based on provided hints.\u003c/p\u003e\n"],["\u003cp\u003eIf no suitable image is found matching the desired type, this method will return \u003ccode\u003enil\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `GCKUIImagePicker` protocol selects an image from `GCKMediaMetadata`. It has a default implementation that selects the first image. Custom implementations can be provided via `GCKCastContext::imagePicker`. The key method, `getImageWithHints:fromMetadata:`, retrieves an image based on `GCKUIImageHints` from provided metadata. It returns the selected `GCKImage` or `nil` if no suitable image is found. This enables picking specific image types for different purposes.\n"],null,["# <GCKUIImagePicker> Protocol\n\n[Instance Methods](#pub-methods) \n\\\u003cGCKUIImagePicker\\\u003e Protocol Reference \n\nOverview\n--------\n\nAn object used for selecting an image for a given purpose from a [GCKMediaMetadata](/cast/docs/reference/ios/interface_g_c_k_media_metadata \"A container for media metadata. \") object.\n\nA 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](/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.\n\nSince\n: 3.0\n\nInherits \\\u003cNSObject\\\u003e.\n\n|--------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| Instance Method Summary ----------------------- ||\n| (nullable [GCKImage](/cast/docs/reference/ios/interface_g_c_k_image) \\*) | - [getImageWithHints:fromMetadata:](/cast/docs/reference/ios/protocol_g_c_k_u_i_image_picker-p#ae99a4131372312a99342b24e8831c561) |\n| | Returns an image of the specified type from the media metadata. [More...](#ae99a4131372312a99342b24e8831c561) |\n| ||\n\nMethod Detail\n-------------\n\n|-----------------------------------------------------------------------------------------------|---|----------------------------------------------------------------------------------------|--------------|\n| - (nullable [GCKImage](/cast/docs/reference/ios/interface_g_c_k_image) \\*) getImageWithHints: | | ([GCKUIImageHints](/cast/docs/reference/ios/interface_g_c_k_u_i_image_hints) \\*) | *imageHints* |\n| fromMetadata: | | (const [GCKMediaMetadata](/cast/docs/reference/ios/interface_g_c_k_media_metadata) \\*) | *metadata* |\n| | | | |\n\nReturns an image of the specified type from the media metadata.\n\nParameters\n:\n\n |------------|----------------------------------------|\n | imageHints | The hints about how to pick the image. |\n | metadata | The media metadata to pick from. |\n\n\nReturns\n: The selected image, or `nil` if there is no appropriate image for the requested type."]]
