Genel Bakış

Medya üst verilerinin kapsayıcısıdır.

Meta verilerde medya türü, isteğe bağlı resim listesi ve meta veri alanları koleksiyonu bulunur. Ortak meta veri alanlarının anahtarları sabitler olarak önceden tanımlanır ancak uygulama, kendi ek alanlarını tanımlayıp kullanabilir.

Önceden tanımlanmış alanların değerleri, önceden tanımlanmış türlere sahiptir. Örneğin, parça numarası bir NSInteger, oluşturma tarihi ise tarih ve saatin ISO-8601 gösterimini içeren bir NSString'dir. Bir alanda yanlış türde bir değer depolamaya çalışmak NSInvalidArgumentException'a neden olur.

Cast protokolünün, belirli bir medya türü için hangi meta veri alanlarının kullanılabileceğini sınırladığını unutmayın. Bir MediaMetadata nesnesi, Cast alıcısına teslim edilmek üzere JSON'a serileştirildiğinde, belirli bir medya türü için desteklenmeyen önceden tanımlanmış alanlar serileştirilmiş biçime dahil edilmez ancak uygulama tarafından tanımlanan alanlar her zaman dahil edilir. Önceden tanımlanmış alanların tam listesi aşağıda verilmiştir:

Alan	Değer Türü	Geçerli Meta Veri Türleri
kGCKMetadataKeyCreationDate	NSDate	GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate	NSDate	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate	NSDate	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack, GCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMusicTrack, GCKMediaMetadataTypePhoto
kGCKMetadataKeyAlbumArtist	NSString	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyAlbumTitle	NSString	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyComposer	NSString	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyDiscNumber	NSInteger	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyTrackNumber	NSInteger	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeySeasonNumber	NSInteger	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyEpisodeNumber	NSInteger	GCKMediaMetadataTypeTVShow
kGCKMetadataKeySeriesTitle	NSString	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyStudio	NSString	GCKMediaMetadataTypeMovie
kGCKMetadataKeyWidth	NSInteger	GCKMediaMetadataTypePhoto
kGCKMetadataKeyHeight	NSInteger	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationName	NSString	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLatitude	double	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	double	GCKMediaMetadataTypePhoto

NSObject'ten devralır. <NSCopying> protokolünü uygular.

Örnek Yöntem Özeti
(instancetype)	- initWithMetadataType:
	Belirtilen medya türüyle yeni ve boş bir MediaMetadata başlatır. Diğer...

(instancetype)	- init
	Genel meta veri türüyle başlatın. Diğer...

(GCKMediaMetadataType)	- metadataType
	Meta veri türü. Diğer...

(NSArray *)	- images
	Resim listesini alır. Diğer...

(void)	- removeAllMediaImages
	Mevcut tüm resimleri kaldırır. Diğer...

(void)	- addImage:
	Resim listesine resim ekler. Diğer...

(BOOL)	- containsKey:
	Nesnenin, verilen anahtara sahip bir alan içerip içermediğini test eder. Diğer...

(NSArray< NSString * > *)	- allKeys
	Nesnede bulunan tüm alanlar için bir anahtar grubu döndürür. Diğer...

(id __nullable)	- objectForKey:
	Bir alanın değerini okur. Diğer...

(void)	- setString:forKey:
	Bir dize alanında değer saklar. Diğer...

(NSString *__nullable)	- stringForKey:
	Bir dize alanının değerini okur. Diğer...

(void)	- setInteger:forKey:
	Bir değeri tam sayı alanında saklar. Diğer...

(NSInteger)	- integerForKey:
	Bir tam sayı alanının değerini okur. Diğer...

(NSInteger)	- integerForKey:defaultValue:
	Bir tam sayı alanının değerini okur. Diğer...

(void)	- setDouble:forKey:
	Bir double alanında değer saklar. Diğer...

(double)	- doubleForKey:
	Çift alanın değerini okur. Diğer...

(double)	- doubleForKey:defaultValue:
	Çift alanın değerini okur. Diğer...

(void)	- setDate:forKey:
	Bir tarih alanındaki değeri, tarihin kısıtlanmış bir ISO-8601 gösterimi olarak saklar. Diğer...

(NSDate *__nullable)	- dateForKey:
	Tarihin kısıtlanmış ISO-8601 gösteriminden bir tarih alanının değerini okur. Diğer...

(NSString *__nullable)	- dateAsStringForKey:
	Bir tarih alanının değerini dize olarak okur. Diğer...

Herkese Açık Özellikler
NSString *const	kGCKMetadataKeyCreationDate
	Dize anahtarı: Oluşturulma tarihi. Diğer...

NSString *const	kGCKMetadataKeyReleaseDate
	Dize anahtarı: Yayın tarihi. Diğer...

NSString *const	kGCKMetadataKeyBroadcastDate
	Dize anahtarı: Yayın tarihi. Diğer...

NSString *const	kGCKMetadataKeyTitle
	Dize anahtarı: Başlık. Diğer...

NSString *const	kGCKMetadataKeySubtitle
	Dize anahtarı: Subtitle. Diğer...

NSString *const	kGCKMetadataKeyArtist
	Dize anahtarı: Sanatçı. Diğer...

NSString *const	kGCKMetadataKeyAlbumArtist
	Dize anahtarı: Albüm sanatçısı. Diğer...

NSString *const	kGCKMetadataKeyAlbumTitle
	Dize anahtarı: Albüm başlığı. Diğer...

NSString *const	kGCKMetadataKeyComposer
	Dize anahtarı: Composer. Diğer...

NSString *const	kGCKMetadataKeyDiscNumber
	Tamsayı anahtarı: Disk numarası. Diğer...

NSString *const	kGCKMetadataKeyTrackNumber
	Tam sayı anahtarı: Parça numarası. Diğer...

NSString *const	kGCKMetadataKeySeasonNumber
	Tam sayı anahtarı: Sezon numarası. Diğer...

NSString *const	kGCKMetadataKeyEpisodeNumber
	Tam sayı anahtarı: Bölüm numarası. Diğer...

NSString *const	kGCKMetadataKeySeriesTitle
	Dize anahtarı: Seri başlığı. Diğer...

NSString *const	kGCKMetadataKeyStudio
	Dize anahtarı: Studio. Diğer...

NSString *const	kGCKMetadataKeyWidth
	Tam sayı anahtarı: Genişlik. Diğer...

NSString *const	kGCKMetadataKeyHeight
	Tam sayı anahtarı: Yükseklik. Diğer...

NSString *const	kGCKMetadataKeyLocationName
	Dize anahtarı: Konum adı. Diğer...

NSString *const	kGCKMetadataKeyLocationLatitude
	Çift anahtar: Konum enlemi. Diğer...

NSString *const	kGCKMetadataKeyLocationLongitude
	Çift anahtar: Konum boylamı. Diğer...

Tesis Özeti
GCKMediaMetadataType	metadataType
	Meta veri türü. Diğer...

Yöntem Ayrıntıları

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Belirtilen medya türüyle yeni ve boş bir MediaMetadata başlatır.

Belirlenmiş başlatıcı.

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

Genel meta veri türüyle başlatın.

- (GCKMediaMetadataType) metadataType

Meta veri türü.

- (NSArray *) images

Resim listesini alır.

- (void) removeAllMediaImages

Mevcut tüm resimleri kaldırır.

- (void) addImage: (GCKImage *) image

Resim listesine resim ekler.

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

Nesnenin, verilen anahtara sahip bir alan içerip içermediğini test eder.

Parameters

key The key.

İadeler: YES, yoksa NO.

- (NSArray<NSString *> *) allKeys

Nesnede bulunan tüm alanlar için bir anahtar grubu döndürür.

- (id __nullable) objectForKey: (NSString *) key

Bir alanın değerini okur.

Parameters

key	The key for the field.

İadeler: Alanın değeri veya alan ayarlanmamışsa nil.

- (void) setString:	(NSString *)	value
forKey:	(NSString *)	key

Bir dize alanında değer saklar.

Parameters

value	The new value for the field.
key	The key for the field.

İstisnalar

NSInvalidArgumentException Anahtar, dize alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (NSString *__nullable) stringForKey: (NSString *) key

Bir dize alanının değerini okur.

Parameters

key	The key for the field.

İadeler: Alanın değeri veya alan ayarlanmamışsa nil.

İstisnalar

NSInvalidArgumentException Anahtar, dize alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (void) setInteger:	(NSInteger)	value
forKey:	(NSString *)	key

Bir değeri tam sayı alanında saklar.

Parameters

value	The new value for the field.
key	The key for the field.

İstisnalar

NSInvalidArgumentException Anahtar, tam sayı alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (NSInteger) integerForKey: (NSString *) key

Bir tam sayı alanının değerini okur.

Parameters

key	The key for the field.

İadeler: Alanın değeri veya alan ayarlanmamışsa 0.

İstisnalar

NSInvalidArgumentException Anahtar, tam sayı alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (NSInteger) integerForKey:	(NSString *)	key
defaultValue:	(NSInteger)	defaultValue

Bir tam sayı alanının değerini okur.

Parameters

key	The key for the field.
defaultValue	The value to return if the field has not been set.

İadeler: Alanın değeri veya alan ayarlanmamışsa verilen varsayılan değer.

İstisnalar

NSInvalidArgumentException Anahtar, tam sayı alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (void) setDouble:	(double)	value
forKey:	(NSString *)	key

Bir double alanında değer saklar.

Parameters

value	The new value for the field.
key	The key for the field.

İstisnalar

NSInvalidArgumentException Anahtar, çift alan olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (double) doubleForKey: (NSString *) key

Çift alanın değerini okur.

Parameters

key	The key for the field.

İadeler: Alanın değeri veya alan ayarlanmamışsa 0.

İstisnalar

NSInvalidArgumentException Anahtar, çift alan olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (double) doubleForKey:	(NSString *)	key
defaultValue:	(double)	defaultValue

Çift alanın değerini okur.

Parameters

defaultValue	The value to return if the field has not been set.
key	The key for the field.

İadeler: Alanın değeri veya alan ayarlanmamışsa verilen varsayılan değer.

İstisnalar

NSInvalidArgumentException Anahtar, çift alan olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (void) setDate:	(NSDate *)	date
forKey:	(NSString *)	key

Bir tarih alanındaki değeri, tarihin kısıtlanmış bir ISO-8601 gösterimi olarak saklar.

Parameters

date	The new value for the field.
key	The key for the field.

İstisnalar

NSInvalidArgumentException Anahtar, tarih alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (NSDate *__nullable) dateForKey: (NSString *) key

Tarihin kısıtlanmış ISO-8601 gösteriminden bir tarih alanının değerini okur.

Parameters

key	The field name.

İadeler: Tarih veya bu alan ayarlanmamışsa nil.

İstisnalar

NSInvalidArgumentException Anahtar, tarih alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

- (NSString *__nullable) dateAsStringForKey: (NSString *) key

Bir tarih alanının değerini dize olarak okur.

Parameters

key	The field name.

İadeler: Tarihin kısıtlanmış ISO-8601 gösterimini içeren bir dize olarak tarih veya bu alan ayarlanmamışsa nil.

İstisnalar

NSInvalidArgumentException Anahtar, tarih alanı olmayan önceden tanımlanmış bir alanı ifade ediyorsa.

Üye Verileriyle İlgili Belgeler

- (NSString* const) kGCKMetadataKeyCreationDate

Dize anahtarı: Oluşturulma tarihi.

Değer, medyanın oluşturulduğu tarih ve/veya saattir (ISO-8601 biçiminde). Örneğin, bu, bir fotoğrafın çekildiği veya bir müzik parçasının kaydedildiği tarih ve saat olabilir.

- (NSString* const) kGCKMetadataKeyReleaseDate

Dize anahtarı: Yayın tarihi.

Değer, medyanın yayınlandığı tarih ve/veya saattir (ISO-8601 biçiminde). Örneğin, bir filmin veya müzik albümünün yayınlandığı tarih olabilir.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Dize anahtarı: Yayın tarihi.

Değer, medyanın ilk yayınlandığı tarih ve/veya saattir (ISO-8601 biçiminde). Örneğin, bu tarih bir TV programı bölümünün ilk yayınlandığı tarih olabilir.

- (NSString* const) kGCKMetadataKeyTitle

Dize anahtarı: Başlık.

Medyanın başlığı. Örneğin, bu bir şarkının, filmin veya TV programı bölümünün adı olabilir. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeySubtitle

Dize anahtarı: Subtitle.

Medyanın alt başlığı. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyArtist

Dize anahtarı: Sanatçı.

Medya içeriğini oluşturan sanatçının adı. Örneğin, bu bir müzisyenin, sanatçının veya fotoğrafçının adı olabilir. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Dize anahtarı: Albüm sanatçısı.

Albümü üreten sanatçının adı. Örneğin, DJ mix'leri gibi derleme albümlerde albüm sanatçısı, albümdeki şarkıların sanatçılarıyla aynı olmayabilir. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Dize anahtarı: Albüm başlığı.

Müzik parçasının ait olduğu albümün başlığı. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyComposer

Dize anahtarı: Composer.

Bir müzik parçasının bestecisinin adı. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyDiscNumber

Tamsayı anahtarı: Disk numarası.

Çok diskli bir albümde müzik parçasının ait olduğu disk numarası (1'den başlayarak sayılır).

- (NSString* const) kGCKMetadataKeyTrackNumber

Tam sayı anahtarı: Parça numarası.

Albüm diskindeki bir müzik parçasının parça numarası. Genellikle parça numaraları 1'den başlayarak sayılır. Ancak bu değer, albümün başında "gizli parça" varsa 0 olabilir.

- (NSString* const) kGCKMetadataKeySeasonNumber

Tam sayı anahtarı: Sezon numarası.

TV programı bölümünün ait olduğu sezon numarası. Genellikle sezon numaraları 1'den başlayarak sayılır. Ancak bu değer, bir TV dizisinin resmi başlangıcından önce yayınlanan bir "pilot" bölüm ise 0 olabilir.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Tam sayı anahtarı: Bölüm numarası.

Bir TV programının belirli bir sezonundaki bölümün numarası. Genellikle bölüm numaraları 1'den başlayarak sayılır. Ancak bu değer, ilk sezonun resmi bir bölümü olarak kabul edilmeyen bir "pilot" bölümse 0 olabilir.

- (NSString* const) kGCKMetadataKeySeriesTitle

Dize anahtarı: Seri başlığı.

Bir dizinin adı. Örneğin, bu bir TV programının veya bir dizi ilgili müzik albümünün adı olabilir. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyStudio

Dize anahtarı: Studio.

Bir medya öğesini üreten kayıt stüdyosunun adı. Örneğin, bu bir film stüdyosunun veya plak şirketinin adı olabilir. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyWidth

Tam sayı anahtarı: Genişlik.

Bir medya öğesinin piksel cinsinden genişliği. Bu genellikle bir fotoğrafın boyutlarını sağlamak için kullanılır.

- (NSString* const) kGCKMetadataKeyHeight

Tam sayı anahtarı: Yükseklik.

Bir medya öğesinin piksel cinsinden yüksekliği. Bu genellikle bir fotoğrafın boyutlarını sağlamak için kullanılır.

- (NSString* const) kGCKMetadataKeyLocationName

Dize anahtarı: Konum adı.

Bir medya öğesinin oluşturulduğu yerin adı. Örneğin, bu bir fotoğrafın çekildiği yer veya bir filmin çekildiği ana yer olabilir. Bu değer, görüntüleme amaçları için uygundur.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Çift anahtar: Konum enlemi.

Bir medya öğesinin oluşturulduğu coğrafi konumun enlem bileşeni. Örneğin, bu bir fotoğrafın çekildiği yer veya bir filmin çekildiği ana yer olabilir.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Çift anahtar: Konum boylamı.

Bir medya öğesinin oluşturulduğu coğrafi konumun boylam bileşeni. Örneğin, bu bir fotoğrafın çekildiği yer veya bir filmin çekildiği ana yer olabilir.

Tesis Ayrıntıları

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Meta veri türü.

GCKMediaMetadata Sınıfı Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Genel Bakış

Örnek Yöntem Özeti

Herkese Açık Özellikler

Tesis Özeti

Yöntem Ayrıntıları

Üye Verileriyle İlgili Belgeler

Tesis Ayrıntıları

GCKMediaMetadata Sınıfı