Protocollo <GCKUIImage Picker>
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Un oggetto utilizzato per selezionare un'immagine per uno scopo specifico da un oggetto GCKMediaMetadata.
Un'implementazione predefinita viene utilizzata internamente dal framework che seleziona sempre la prima immagine dai metadati per tutti gli utilizzi. L'applicazione può fornire un'implementazione personalizzata impostando la proprietà GCKCastContext::imagePicker.
- Dal
- 3,0
Eredita <NSObject>.
Restituisce un'immagine del tipo specificato dai metadati multimediali.
- Parameters
-
imageHints | The hints about how to pick the image. |
metadata | The media metadata to pick from. |
- Ritorni
- L'immagine selezionata o
nil
se non esiste un'immagine appropriata per il tipo richiesto.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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."]]