Visão geral
Um contêiner para metadados de mídia.
Os metadados têm um tipo de mídia, uma lista opcional de imagens e uma coleção de campos de metadados. As chaves para campos de metadados comuns são predefinidas como constantes, mas o aplicativo pode definir e usar outros campos próprios.
Os valores dos campos predefinidos têm tipos predefinidos. Por exemplo, um número de faixa é um NSInteger, e uma data de criação é um NSString que contém uma representação ISO-8601 de uma data e hora. A tentativa de armazenar um valor de um tipo incorreto em um campo vai gerar uma NSInvalidArgumentException.
O protocolo Cast limita quais campos de metadados podem ser usados para um determinado tipo de mídia. Quando um objeto MediaMetadata é serializado em JSON para entrega a um receptor do Cast, todos os campos predefinidos que não são compatíveis com um determinado tipo de mídia não são incluídos na forma serializada, mas todos os campos definidos pelo aplicativo são sempre incluídos. Confira a lista completa de campos predefinidos:
Herda o NSObject. Implementa <NSCopying>.
Resumo do método de instância | |
| (instancetype) | - initWithMetadataType: |
| Inicializa um novo MediaMetadata vazio com o tipo de mídia especificado. Mais... | |
| (instancetype) | - init |
| Inicialize com o tipo de metadados genérico. Mais... | |
| (GCKMediaMetadataType) | - metadataType |
| O tipo de metadados. Mais... | |
| (NSArray *) | - images |
| Recebe a lista de imagens. Mais... | |
| (void) | - removeAllMediaImages |
| Remove todas as imagens atuais. Mais... | |
| (void) | - addImage: |
| Adiciona uma imagem à lista de imagens. Mais... | |
| (BOOL) | - containsKey: |
| Testa se o objeto contém um campo com a chave especificada. Mais... | |
| (NSArray< NSString * > *) | - allKeys |
| Retorna um conjunto de chaves para todos os campos presentes no objeto. Mais... | |
| (id __nullable) | - objectForKey: |
| Lê o valor de um campo. Mais... | |
| (void) | - setString:forKey: |
| Armazena um valor em um campo de string. Mais... | |
| (NSString *__nullable) | - stringForKey: |
| Lê o valor de um campo de string. Mais... | |
| (void) | - setInteger:forKey: |
| Armazena um valor em um campo de número inteiro. Mais... | |
| (NSInteger) | - integerForKey: |
| Lê o valor de um campo de número inteiro. Mais... | |
| (NSInteger) | - integerForKey:defaultValue: |
| Lê o valor de um campo de número inteiro. Mais... | |
| (void) | - setDouble:forKey: |
| Armazena um valor em um campo double. Mais... | |
| (double) | - doubleForKey: |
| Lê o valor de um campo double. Mais... | |
| (double) | - doubleForKey:defaultValue: |
| Lê o valor de um campo double. Mais... | |
| (void) | - setDate:forKey: |
| Armazena um valor em um campo de data como uma representação ISO-8601 restrita da data. Mais... | |
| (NSDate *__nullable) | - dateForKey: |
| Lê o valor de um campo de data da representação ISO-8601 restrita da data. Mais... | |
| (NSString *__nullable) | - dateAsStringForKey: |
| Lê o valor de um campo de data como uma string. Mais... | |
Atributos públicos | |
| NSString *const | kGCKMetadataKeyCreationDate |
| Chave de string: data de criação. Mais... | |
| NSString *const | kGCKMetadataKeyReleaseDate |
| Chave de string: data de lançamento. Mais... | |
| NSString *const | kGCKMetadataKeyBroadcastDate |
| Chave de string: data de transmissão. Mais... | |
| NSString *const | kGCKMetadataKeyTitle |
| Chave da string: Title. Mais... | |
| NSString *const | kGCKMetadataKeySubtitle |
| Chave da string: Subtitle. Mais... | |
| NSString *const | kGCKMetadataKeyArtist |
| Chave de string: artista. Mais... | |
| NSString *const | kGCKMetadataKeyAlbumArtist |
| Chave de string: artista do álbum. Mais... | |
| NSString *const | kGCKMetadataKeyAlbumTitle |
| Chave de string: título do álbum. Mais... | |
| NSString *const | kGCKMetadataKeyComposer |
| Chave de string: Composer. Mais... | |
| NSString *const | kGCKMetadataKeyDiscNumber |
| Chave de número inteiro: número do disco. Mais... | |
| NSString *const | kGCKMetadataKeyTrackNumber |
| Chave de número inteiro: número da faixa. Mais... | |
| NSString *const | kGCKMetadataKeySeasonNumber |
| Chave de número inteiro: número da temporada. Mais... | |
| NSString *const | kGCKMetadataKeyEpisodeNumber |
| Chave de número inteiro: número do episódio. Mais... | |
| NSString *const | kGCKMetadataKeySeriesTitle |
| Chave de string: título da série. Mais... | |
| NSString *const | kGCKMetadataKeyStudio |
| Chave da string: Studio. Mais... | |
| NSString *const | kGCKMetadataKeyWidth |
| Chave de número inteiro: Width. Mais... | |
| NSString *const | kGCKMetadataKeyHeight |
| Chave de número inteiro: altura. Mais... | |
| NSString *const | kGCKMetadataKeyLocationName |
| Chave de string: nome do local. Mais... | |
| NSString *const | kGCKMetadataKeyLocationLatitude |
| Chave dupla: latitude do local. Mais... | |
| NSString *const | kGCKMetadataKeyLocationLongitude |
| Chave dupla: longitude do local. Mais... | |
Resumo da propriedade | |
| GCKMediaMetadataType | metadataType |
| O tipo de metadados. Mais... | |
Detalhes do método
| - (instancetype) initWithMetadataType: | (GCKMediaMetadataType) | metadataType |
Inicializa um novo MediaMetadata vazio com o tipo de mídia especificado.
Inicializador designado.
- Parameters
-
metadataType The media type; one of the GCKMediaMetadataType constants, or a value greater than or equal to GCKMediaMetadataTypeUser for custom media types.
| - (instancetype) init |
Inicialize com o tipo de metadados genérico.
| - (GCKMediaMetadataType) metadataType |
O tipo de metadados.
| - (NSArray *) images |
Recebe a lista de imagens.
| - (void) removeAllMediaImages |
Remove todas as imagens atuais.
| - (void) addImage: | (GCKImage *) | image |
Adiciona uma imagem à lista de imagens.
- Parameters
-
image The image to add.
| - (BOOL) containsKey: | (NSString *) | key |
Testa se o objeto contém um campo com a chave especificada.
- Parameters
-
key The key.
- Retorna
YESse o campo existir,NOcaso contrário.
| - (NSArray<NSString *> *) allKeys |
Retorna um conjunto de chaves para todos os campos presentes no objeto.
| - (id __nullable) objectForKey: | (NSString *) | key |
Lê o valor de um campo.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo ou
nilse o campo não tiver sido definido.
| - (void) setString: | (NSString *) | value | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo de string.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja de string.
| - (NSString *__nullable) stringForKey: | (NSString *) | key |
Lê o valor de um campo de string.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo ou
nilse o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja de string.
| - (void) setInteger: | (NSInteger) | value | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo de número inteiro.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de número inteiro.
| - (NSInteger) integerForKey: | (NSString *) | key |
Lê o valor de um campo de número inteiro.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo ou 0 se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de número inteiro.
| - (NSInteger) integerForKey: | (NSString *) | key | |
| defaultValue: | (NSInteger) | defaultValue | |
Lê o valor de um campo de número inteiro.
- Parameters
-
key The key for the field. defaultValue The value to return if the field has not been set.
- Retorna
- O valor do campo ou o valor padrão determinado se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de número inteiro.
| - (void) setDouble: | (double) | value | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo double.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo double.
| - (double) doubleForKey: | (NSString *) | key |
Lê o valor de um campo double.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo ou 0 se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo double.
| - (double) doubleForKey: | (NSString *) | key | |
| defaultValue: | (double) | defaultValue | |
Lê o valor de um campo double.
- Parameters
-
defaultValue The value to return if the field has not been set. key The key for the field.
- Retorna
- O valor do campo ou o valor padrão determinado se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo double.
| - (void) setDate: | (NSDate *) | date | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo de data como uma representação ISO-8601 restrita da data.
- Parameters
-
date The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de data.
| - (NSDate *__nullable) dateForKey: | (NSString *) | key |
Lê o valor de um campo de data da representação ISO-8601 restrita da data.
- Parameters
-
key The field name.
- Retorna
- A data ou
nilse o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de data.
| - (NSString *__nullable) dateAsStringForKey: | (NSString *) | key |
Lê o valor de um campo de data como uma string.
- Parameters
-
key The field name.
- Retorna
- A data como uma string que contém a representação restrita da data no formato ISO-8601 ou
nilse esse campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de data.
Documentação de dados de membros
| - (NSString* const) kGCKMetadataKeyCreationDate |
Chave de string: data de criação.
O valor é a data e/ou hora em que a mídia foi criada, no formato ISO-8601. Por exemplo, a data e a hora em que uma fotografia foi tirada ou uma música foi gravada.
| - (NSString* const) kGCKMetadataKeyReleaseDate |
Chave de string: data de lançamento.
O valor é a data e/ou hora em que a mídia foi lançada, no formato ISO-8601. Por exemplo, a data de lançamento de um filme ou álbum musical.
| - (NSString* const) kGCKMetadataKeyBroadcastDate |
Chave de string: data de transmissão.
O valor é a data e/ou hora em que a mídia foi transmitida pela primeira vez, no formato ISO-8601. Por exemplo, a data em que um episódio de um programa de TV foi exibido pela primeira vez.
| - (NSString* const) kGCKMetadataKeyTitle |
Chave da string: Title.
O título da mídia. Por exemplo, o título de uma música, um filme ou um episódio de programa de TV. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeySubtitle |
Chave da string: Subtitle.
O subtítulo da mídia. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyArtist |
Chave de string: artista.
O nome do artista que criou a mídia. Por exemplo, o nome de um músico, artista ou fotógrafo. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyAlbumArtist |
Chave de string: artista do álbum.
O nome do artista que produziu um álbum. Por exemplo, em álbuns de compilação, como mixes de DJ, o artista do álbum não é necessariamente o mesmo que os artistas das músicas individuais do álbum. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyAlbumTitle |
Chave de string: título do álbum.
O título do álbum a que uma música pertence. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyComposer |
Chave de string: Composer.
O nome do compositor de uma música. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyDiscNumber |
Chave de número inteiro: número do disco.
O número do disco (contando a partir de 1) a que uma faixa de música pertence em um álbum com vários discos.
| - (NSString* const) kGCKMetadataKeyTrackNumber |
Chave de número inteiro: número da faixa.
O número da faixa de uma música em um disco de álbum. Normalmente, os números das faixas são contados a partir de 1, mas esse valor pode ser 0 se for uma "faixa oculta" no início de um álbum.
| - (NSString* const) kGCKMetadataKeySeasonNumber |
Chave de número inteiro: número da temporada.
O número da temporada a que um episódio de um programa de TV pertence. Normalmente, os números das temporadas são contados a partir de 1, mas esse valor pode ser 0 se for um episódio "piloto" que antecede o início oficial de uma série de TV.
| - (NSString* const) kGCKMetadataKeyEpisodeNumber |
Chave de número inteiro: número do episódio.
O número de um episódio em uma determinada temporada de um programa de TV. Normalmente, os números dos episódios são contados a partir de 1, mas esse valor pode ser 0 se for um episódio "piloto" que não é considerado um episódio oficial da primeira temporada.
| - (NSString* const) kGCKMetadataKeySeriesTitle |
Chave de string: título da série.
O nome de uma série. Por exemplo, o nome de um programa de TV ou uma série de álbuns de música relacionados. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyStudio |
Chave da string: Studio.
O nome de um estúdio de gravação que produziu uma mídia. Por exemplo, pode ser o nome de um estúdio de cinema ou de uma gravadora. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyWidth |
Chave de número inteiro: Width.
A largura de uma mídia, em pixels. Isso normalmente é usado para fornecer as dimensões de uma fotografia.
| - (NSString* const) kGCKMetadataKeyHeight |
Chave de número inteiro: altura.
A altura de uma mídia, em pixels. Isso normalmente é usado para fornecer as dimensões de uma fotografia.
| - (NSString* const) kGCKMetadataKeyLocationName |
Chave de string: nome do local.
O nome de um local em que uma mídia foi criada. Por exemplo, pode ser o local de uma fotografia ou o principal local de filmagem de um filme. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyLocationLatitude |
Chave dupla: latitude do local.
O componente de latitude da localização geográfica em que uma mídia foi criada. Por exemplo, pode ser o local de uma fotografia ou o principal local de filmagem de um filme.
| - (NSString* const) kGCKMetadataKeyLocationLongitude |
Chave dupla: longitude do local.
O componente de longitude da localização geográfica em que um item de mídia foi criado. Por exemplo, pode ser o local de uma fotografia ou o principal local de filmagem de um filme.
Detalhes da propriedade
|
readnonatomicassign |
O tipo de metadados.