Informações gerais
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 é livre para definir e usar campos adicionais próprios.
Os valores dos campos predefinidos têm tipos predefinidos. Por exemplo, o número da faixa é NSInteger, e a data de criação é uma NSString que contém uma representação ISO-8601 de data e hora. A tentativa de armazenar um valor de um tipo incorreto em um campo vai gerar uma NSInvalidArgumentException.
O protocolo de transmissão limita quais campos de metadados podem ser usados para determinado tipo de mídia. Quando um objeto MediaMetadata é serializado para JSON para entrega a um receptor do Cast, os campos predefinidos que não são compatíveis com um determinado tipo de mídia não são incluídos no formulário serializado, mas os campos definidos pelo aplicativo sempre são incluídos. Confira a lista completa de campos predefinidos:
Herda NSObject, <NSCopy> e <NSSecureCoding>.
Resumo do método de instância | |
| (instancetype) | - initWithMetadataType: |
| Inicializa um MediaMetadata novo e vazio com o tipo de mídia especificado. Mais... | |
| (instancetype) | - init |
| Inicializar com o tipo de metadados genéricos. 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 fornecida. Mais... | |
| (NSArray< NSString * > *) | - allKeys |
| Retorna um conjunto de chaves para todos os campos presentes no objeto. Mais... | |
| (nullable id) | - objectForKey: |
| Lê o valor de um campo. Mais... | |
| (void) | - setString:forKey: |
| Armazena um valor em um campo de string. Mais... | |
| (nullable NSString *) | - 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 com números inteiros. Mais... | |
| (NSInteger) | - integerForKey:defaultValue: |
| Lê o valor de um campo com números inteiros. 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... | |
| (nullable NSDate *) | - dateForKey: |
| Lê o valor de um campo de data a partir da representação ISO-8601 restrita da data. Mais... | |
| (nullable NSString *) | - 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 da string: data da transmissão. Mais... | |
| NSString *const | kGCKMetadataKeyTitle |
| Chave de string: título. Mais... | |
| NSString *const | kGCKMetadataKeySubtitle |
| Chave da string: legenda. Mais... | |
| NSString *const | kGCKMetadataKeyArtist |
| Chave da string: artista. Mais... | |
| NSString *const | kGCKMetadataKeyAlbumArtist |
| Chave da 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 inteira: número da temporada. Mais... | |
| NSString *const | kGCKMetadataKeyEpisodeNumber |
| Chave inteira: número do episódio. Mais... | |
| NSString *const | kGCKMetadataKeySeriesTitle |
| Chave da string: título da série. Mais... | |
| NSString *const | kGCKMetadataKeyStudio |
| Chave da string: Studio. Mais... | |
| NSString *const | kGCKMetadataKeyWidth |
| Chave de número inteiro: largura. Mais... | |
| NSString *const | kGCKMetadataKeyHeight |
| Chave de número inteiro: altura. Mais... | |
| NSString *const | kGCKMetadataKeyLocationName |
| Chave da string: nome do local. Mais... | |
| NSString *const | kGCKMetadataKeyLocationLatitude |
| Tecla dupla: latitude do local. Mais... | |
| NSString *const | kGCKMetadataKeyLocationLongitude |
| Tecla dupla: longitude do local. Mais... | |
| NSString *const | kGCKMetadataKeyBookTitle |
| Chave de string: título do livro. Mais... | |
| NSString *const | kGCKMetadataKeyChapterNumber |
| Chave de número inteiro: número do capítulo. Mais... | |
| NSString *const | kGCKMetadataKeyChapterTitle |
| Chave da string: título do capítulo. Mais... | |
| NSString *const | kGCKMetadataKeySectionDuration |
| Chave dupla: duração da seção. Mais... | |
| NSString *const | kGCKMetadataKeySectionStartTimeInMedia |
| Tecla dupla: horário de início da seção em mídia. Mais... | |
| NSString *const | kGCKMetadataKeySectionStartAbsoluteTime |
| Chave dupla: horário de início absoluto da seção. Mais... | |
| NSString *const | kGCKMetadataKeySectionStartTimeInContainer |
| Chave dupla: horário de início da seção no contêiner. Mais... | |
| NSString *const | kGCKMetadataKeyQueueItemID |
| Chave dupla: ID do item da fila. Mais... | |
Resumo da propriedade | |
| GCKMediaMetadataType | metadataType |
| O tipo de metadados. Mais... | |
Detalhes dos métodos
| - (instancetype) initWithMetadataType: | (GCKMediaMetadataType) | metadataType |
Inicializa um MediaMetadata novo e vazio com o tipo de mídia especificado.
Iniciador 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 |
Inicializar com o tipo de metadados genéricos.
| - (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 fornecida.
- Parameters
-
key The key.
- Retorna
YESse o campo existir. Caso contrário,NO.
| - (NSArray<NSString *> *) allKeys |
Retorna um conjunto de chaves para todos os campos presentes no objeto.
| - (nullable id) 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 um campo de string.
| - (nullable NSString *) 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 um campo 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 com números inteiros.
- 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 com números inteiros.
- 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 fornecido 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 fornecido 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 refere a um campo predefinido que não é um campo de data.
| - (nullable NSDate *) dateForKey: | (NSString *) | key |
Lê o valor de um campo de data a partir da representação ISO-8601 restrita da data.
- Parameters
-
key The field name.
- Retorna
- A data, ou
nil, se esse campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se refere a um campo predefinido que não é um campo de data.
| - (nullable NSString *) 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 ISO-8601 da data, ou
nilse esse campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se refere a um campo predefinido que não é um campo de data.
Documentação de dados dos participantes
| - (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, pode ser a data e a hora em que uma foto 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, pode ser a data em que um filme ou álbum de música foi lançado.
| - (NSString* const) kGCKMetadataKeyBroadcastDate |
Chave da string: data da transmissão.
O valor é a data e/ou o horário em que a mídia foi transmitida pela primeira vez, no formato ISO-8601. Por exemplo, pode ser a data em que o episódio de um programa de TV foi ao ar pela primeira vez.
| - (NSString* const) kGCKMetadataKeyTitle |
Chave de string: título.
O título da mídia. Por exemplo, o título de uma música, filme ou episódio de programa de TV. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeySubtitle |
Chave da string: legenda.
O subtítulo da mídia. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyArtist |
Chave da string: artista.
O nome do artista que criou a mídia. Por exemplo, pode ser o nome de um músico, artista ou fotógrafo. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyAlbumArtist |
Chave da string: artista do álbum.
O nome do artista que produziu um álbum. Por exemplo, em álbuns de compilação como mixes de DJs, o artista do álbum não é necessariamente o mesmo que as 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 ao qual a 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) ao qual 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. No entanto, esse valor pode ser 0 se for uma "faixa oculta" no início de um álbum.
| - (NSString* const) kGCKMetadataKeySeasonNumber |
Chave inteira: número da temporada.
É o número da temporada a que o episódio de um programa de TV pertence. Normalmente, os números das temporadas são contados a partir de 1. No entanto, esse valor pode ser 0 se for um episódio "piloto" anterior ao início oficial de uma série de TV.
| - (NSString* const) kGCKMetadataKeyEpisodeNumber |
Chave inteira: 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 de episódios são contados a partir de 1. No entanto, 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 da string: título da série.
O nome de uma série. Por exemplo, pode ser 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 um conteúdo de 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: largura.
A largura de uma mídia em pixels. Esse recurso 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. Esse recurso normalmente é usado para fornecer as dimensões de uma fotografia.
| - (NSString* const) kGCKMetadataKeyLocationName |
Chave da string: nome do local.
O nome do local em que uma mídia foi criada. Por exemplo, pode ser o local de uma fotografia ou o local de filmagem do diretor de um filme. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyLocationLatitude |
Tecla 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 local de filmagem do diretor de um filme.
| - (NSString* const) kGCKMetadataKeyLocationLongitude |
Tecla dupla: longitude do local.
O componente de longitude da localização geográfica em que uma mídia foi criada. Por exemplo, pode ser o local de uma fotografia ou o local de filmagem do diretor de um filme.
| - (NSString* const) kGCKMetadataKeyBookTitle |
Chave de string: título do livro.
O título de um audiolivro.
- Como
- 4.3.5
| - (NSString* const) kGCKMetadataKeyChapterNumber |
Chave de número inteiro: número do capítulo.
O número de um capítulo de um audiolivro.
- Como
- 4.3.5
| - (NSString* const) kGCKMetadataKeyChapterTitle |
Chave da string: título do capítulo.
O título de um capítulo de um audiolivro.
- Como
- 4.3.5
| - (NSString* const) kGCKMetadataKeySectionDuration |
Chave dupla: duração da seção.
A duração da seção em segundos. Usado para metadados de fila. Por exemplo, pode ser a duração de um programa de TV na fila, a duração de um capítulo de um audiolivro ou um programa de uma transmissão ao vivo longa.
- Como
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartTimeInMedia |
Tecla dupla: horário de início da seção em mídia.
É o deslocamento em segundos do horário de início da seção em relação ao início do item de mídia. Usado para metadados de fila.
- Como
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime |
Chave dupla: horário de início absoluto da seção.
O horário absoluto do início da seção, em tempo de época em segundos. Usado para metadados de fila.
- Como
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartTimeInContainer |
Chave dupla: horário de início da seção no contêiner.
O deslocamento do horário de início da seção dentro do contêiner completo. Usado para metadados de fila.
- Como
- 4.4.1
| - (NSString* const) kGCKMetadataKeyQueueItemID |
Chave dupla: ID do item da fila.
ID do item da fila que inclui o horário de início da seção. Usado para metadados de fila.
- Como
- 4.4.1
Detalhe da propriedade
|
readnonatomicassign |
O tipo de metadados.