ภาพรวม

คอนเทนเนอร์สําหรับข้อมูลเมตาของสื่อ

ข้อมูลเมตามีประเภทสื่อ รายการรูปภาพที่ไม่บังคับ และคอลเล็กชันของช่องข้อมูลเมตา คีย์สําหรับช่องข้อมูลเมตาที่พบบ่อยได้รับการกําหนดไว้ล่วงหน้าเป็นค่าคงที่ แต่แอปพลิเคชันมีอิสระในการระบุและใช้ช่องเพิ่มเติมของตัวเอง

ค่าของช่องที่กําหนดไว้ล่วงหน้ามีประเภทที่กําหนดไว้ล่วงหน้า เช่น หมายเลขแทร็กคือ NSInteger และวันที่สร้างคือ NSString ที่มีการนําเสนอวันที่และเวลาในรูปแบบ ISO-8601 การพยายามจัดเก็บค่าประเภทที่ไม่ถูกต้องในช่องจะทําให้ NSinvalidArgumentข้อยกเว้น

โปรดทราบว่าโปรโตคอลแคสต์จะจํากัดช่องข้อมูลเมตาที่ใช้กับสื่อประเภทหนึ่งๆ ได้ เมื่อออบเจ็กต์ MediaMetadata เรียงลําดับเป็น JSON เพื่อส่งไปยังตัวรับการแคสต์ ช่องที่กําหนดไว้ล่วงหน้าซึ่งไม่รองรับประเภทสื่อหนึ่งๆ จะไม่รวมอยู่ในแบบฟอร์มแบบอนุกรม แต่จะมีช่องที่กําหนดโดยแอปพลิเคชันเสมอ รายการช่องที่กําหนดไว้ล่วงหน้ามีดังนี้

ช่อง	ประเภทค่า	ประเภทข้อมูลเมตาที่ถูกต้อง
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	คู่	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	คู่	GCKMediaMetadataTypePhoto

รับค่า NSObject ใช้งาน <NSCopying>

สรุปเมธอดของอินสแตนซ์
(instancetype)	- initWithMetadataType:
	เริ่มต้น MediaMetadata ใหม่ที่ว่างเปล่าด้วยประเภทสื่อที่ระบุ เพิ่มเติม...

(instancetype)	- init
	เริ่มต้นด้วยประเภทข้อมูลเมตาทั่วไป เพิ่มเติม...

(GCKMediaMetadataType)	- metadataType
	ประเภทของข้อมูลเมตา เพิ่มเติม...

(NSArray *)	- images
	รับรายการรูปภาพ เพิ่มเติม...

(void)	- removeAllMediaImages
	นํารูปภาพปัจจุบันทั้งหมดออก เพิ่มเติม...

(void)	- addImage:
	เพิ่มรูปภาพในรายการรูปภาพ เพิ่มเติม...

(BOOL)	- containsKey:
	ทดสอบว่าออบเจ็กต์มีช่องที่มีคีย์ที่ระบุหรือไม่ เพิ่มเติม...

(NSArray< NSString * > *)	- allKeys
	แสดงผลชุดคีย์สําหรับทุกช่องที่อยู่ในออบเจ็กต์ เพิ่มเติม...

(id __nullable)	- objectForKey:
	อ่านค่าของช่อง เพิ่มเติม...

(void)	- setString:forKey:
	จัดเก็บค่าในช่องสตริง เพิ่มเติม...

(NSString *__nullable)	- stringForKey:
	อ่านค่าของช่องสตริง เพิ่มเติม...

(void)	- setInteger:forKey:
	จัดเก็บค่าในช่องจํานวนเต็ม เพิ่มเติม...

(NSInteger)	- integerForKey:
	อ่านค่าของช่องจํานวนเต็ม เพิ่มเติม...

(NSInteger)	- integerForKey:defaultValue:
	อ่านค่าของช่องจํานวนเต็ม เพิ่มเติม...

(void)	- setDouble:forKey:
	จัดเก็บค่าในช่องคู่ เพิ่มเติม...

(double)	- doubleForKey:
	อ่านค่าของช่องคู่ เพิ่มเติม...

(double)	- doubleForKey:defaultValue:
	อ่านค่าของช่องคู่ เพิ่มเติม...

(void)	- setDate:forKey:
	จัดเก็บค่าในช่องวันที่เป็นการนําเสนอวันที่ในรูปแบบ ISO-8601 แบบจํากัด เพิ่มเติม...

(NSDate *__nullable)	- dateForKey:
	อ่านค่าของช่องวันที่จากการแสดง ISO-8601 แบบจํากัดของวันที่ เพิ่มเติม...

(NSString *__nullable)	- dateAsStringForKey:
	อ่านค่าของช่องวันที่เป็นสตริง เพิ่มเติม...

แอตทริบิวต์สาธารณะ
NSString *const	kGCKMetadataKeyCreationDate
	คีย์สตริง: วันที่สร้าง เพิ่มเติม...

NSString *const	kGCKMetadataKeyReleaseDate
	คีย์สตริง: วันที่วางจําหน่าย เพิ่มเติม...

NSString *const	kGCKMetadataKeyBroadcastDate
	คีย์สตริง: วันที่ออกอากาศ เพิ่มเติม...

NSString *const	kGCKMetadataKeyTitle
	คีย์สตริง: ชื่อ เพิ่มเติม...

NSString *const	kGCKMetadataKeySubtitle
	คีย์สตริง: ชื่อรอง เพิ่มเติม...

NSString *const	kGCKMetadataKeyArtist
	คีย์สตริง: ศิลปิน เพิ่มเติม...

NSString *const	kGCKMetadataKeyAlbumArtist
	คีย์สตริง: ศิลปินอัลบั้ม เพิ่มเติม...

NSString *const	kGCKMetadataKeyAlbumTitle
	คีย์สตริง: ชื่ออัลบั้ม เพิ่มเติม...

NSString *const	kGCKMetadataKeyComposer
	คีย์สตริง: Composer เพิ่มเติม...

NSString *const	kGCKMetadataKeyDiscNumber
	คีย์จํานวนเต็ม: หมายเลขดิสก์ เพิ่มเติม...

NSString *const	kGCKMetadataKeyTrackNumber
	คีย์จํานวนเต็ม: หมายเลขติดตาม เพิ่มเติม...

NSString *const	kGCKMetadataKeySeasonNumber
	คีย์จํานวนเต็ม: หมายเลขซีซัน เพิ่มเติม...

NSString *const	kGCKMetadataKeyEpisodeNumber
	คีย์จํานวนเต็ม: หมายเลขตอน เพิ่มเติม...

NSString *const	kGCKMetadataKeySeriesTitle
	คีย์สตริง: ชื่อชุดหนังสือ เพิ่มเติม...

NSString *const	kGCKMetadataKeyStudio
	คีย์สตริง: Studio เพิ่มเติม...

NSString *const	kGCKMetadataKeyWidth
	คีย์จํานวนเต็ม: ความกว้าง เพิ่มเติม...

NSString *const	kGCKMetadataKeyHeight
	จํานวนเต็ม: ความสูง เพิ่มเติม...

NSString *const	kGCKMetadataKeyLocationName
	คีย์สตริง: ชื่อสถานที่ตั้ง เพิ่มเติม...

NSString *const	kGCKMetadataKeyLocationLatitude
	Double key: ละติจูดของตําแหน่ง เพิ่มเติม...

NSString *const	kGCKMetadataKeyLocationLongitude
	คีย์คู่: ลองจิจูดของสถานที่ เพิ่มเติม...

สรุปพร็อพเพอร์ตี้
GCKMediaMetadataType	metadataType
	ประเภทของข้อมูลเมตา เพิ่มเติม...

รายละเอียดเมธอด

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

เริ่มต้น MediaMetadata ใหม่ที่ว่างเปล่าด้วยประเภทสื่อที่ระบุ

ตัวเริ่มต้นที่กําหนด

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

เริ่มต้นด้วยประเภทข้อมูลเมตาทั่วไป

- (GCKMediaMetadataType) metadataType

ประเภทของข้อมูลเมตา

- (NSArray *) images

รับรายการรูปภาพ

- (void) removeAllMediaImages

นํารูปภาพปัจจุบันทั้งหมดออก

- (void) addImage: (GCKImage *) image

เพิ่มรูปภาพในรายการรูปภาพ

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

ทดสอบว่าออบเจ็กต์มีช่องที่มีคีย์ที่ระบุหรือไม่

Parameters

key The key.

การคืนสินค้า: YES หากมีช่องนี้ NO หรือไม่

- (NSArray<NSString *> *) allKeys

แสดงผลชุดคีย์สําหรับทุกช่องที่อยู่ในออบเจ็กต์

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

อ่านค่าของช่อง

Parameters

key	The key for the field.

การคืนสินค้า: ค่าของช่องนี้ หรือ nil หากไม่ได้ตั้งค่าช่องนี้

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

จัดเก็บค่าในช่องสตริง

Parameters

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

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้าที่ไม่ใช่ช่องสตริง

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

อ่านค่าของช่องสตริง

Parameters

key	The key for the field.

การคืนสินค้า: ค่าของช่องนี้ หรือ nil หากไม่ได้ตั้งค่าช่องนี้

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้าที่ไม่ใช่ช่องสตริง

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

จัดเก็บค่าในช่องจํานวนเต็ม

Parameters

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

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์อ้างอิงถึงช่องที่กําหนดไว้ล่วงหน้า ซึ่งไม่ใช่ช่องจํานวนเต็ม

- (NSInteger) integerForKey: (NSString *) key

อ่านค่าของช่องจํานวนเต็ม

Parameters

key	The key for the field.

การคืนสินค้า: ค่าของช่องนี้ หรือ 0 หากยังไม่ได้ตั้งค่า

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์อ้างอิงถึงช่องที่กําหนดไว้ล่วงหน้า ซึ่งไม่ใช่ช่องจํานวนเต็ม

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

อ่านค่าของช่องจํานวนเต็ม

Parameters

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

การคืนสินค้า: ค่าในช่องหรือค่าเริ่มต้นที่กําหนด หากไม่ได้ตั้งค่าช่องนี้

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์อ้างอิงถึงช่องที่กําหนดไว้ล่วงหน้า ซึ่งไม่ใช่ช่องจํานวนเต็ม

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

จัดเก็บค่าในช่องคู่

Parameters

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

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้า ซึ่งไม่ได้เป็นช่องคู่

- (double) doubleForKey: (NSString *) key

อ่านค่าของช่องคู่

Parameters

key	The key for the field.

การคืนสินค้า: ค่าของช่องนี้ หรือ 0 หากยังไม่ได้ตั้งค่า

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้า ซึ่งไม่ได้เป็นช่องคู่

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

อ่านค่าของช่องคู่

Parameters

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

การคืนสินค้า: ค่าในช่องหรือค่าเริ่มต้นที่กําหนด หากไม่ได้ตั้งค่าช่องนี้

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้า ซึ่งไม่ได้เป็นช่องคู่

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

จัดเก็บค่าในช่องวันที่เป็นการนําเสนอวันที่ในรูปแบบ ISO-8601 แบบจํากัด

Parameters

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

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้าซึ่งไม่ใช่ช่องวันที่

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

อ่านค่าของช่องวันที่จากการแสดง ISO-8601 แบบจํากัดของวันที่

Parameters

key	The field name.

การคืนสินค้า: วันที่ หรือ nil หากไม่ได้ตั้งค่าช่องนี้

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้าซึ่งไม่ใช่ช่องวันที่

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

อ่านค่าของช่องวันที่เป็นสตริง

Parameters

key	The field name.

การคืนสินค้า: วันที่เป็นสตริงที่แสดงวันที่ ISO-8601 ที่ถูกจํากัด หรือ nil หากไม่ได้ตั้งค่าช่องนี้

ข้อยกเว้น

NSA อาร์กิวเมนต์ไม่ถูกต้อง หากคีย์หมายถึงช่องที่กําหนดไว้ล่วงหน้าซึ่งไม่ใช่ช่องวันที่

เอกสารประกอบข้อมูลสมาชิก

- (NSString* const) kGCKMetadataKeyCreationDate

คีย์สตริง: วันที่สร้าง

ค่าคือวันที่และ/หรือเวลาที่สร้างสื่อในรูปแบบ ISO-8601 ตัวอย่างเช่น ส่วนนี้อาจเป็นวันที่และเวลาที่ถ่ายภาพหรือบันทึกชิ้นดนตรี

- (NSString* const) kGCKMetadataKeyReleaseDate

คีย์สตริง: วันที่วางจําหน่าย

ค่าคือวันที่และ/หรือเวลาที่เผยแพร่สื่อในรูปแบบ ISO-8601 ตัวอย่างเช่น อาจเป็นวันที่มีการเปิดตัวภาพยนตร์หรืออัลบั้มเพลง

- (NSString* const) kGCKMetadataKeyBroadcastDate

คีย์สตริง: วันที่ออกอากาศ

ค่าคือวันที่และ/หรือเวลาที่สื่อออกอากาศเป็นครั้งแรกในรูปแบบ ISO-8601 ตัวอย่างเช่น นี่อาจเป็นวันที่ที่ตอนของรายการทีวีออกอากาศเป็นครั้งแรก

- (NSString* const) kGCKMetadataKeyTitle

คีย์สตริง: ชื่อ

ชื่อสื่อ ซึ่งอาจเป็นชื่อเพลง ภาพยนตร์ หรือตอนของรายการทีวี ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeySubtitle

คีย์สตริง: ชื่อรอง

ชื่อรองของสื่อ ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyArtist

คีย์สตริง: ศิลปิน

ชื่อศิลปินที่สร้างสื่อ เช่น ชื่อนักดนตรี นักแสดง หรือช่างภาพ ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyAlbumArtist

คีย์สตริง: ศิลปินอัลบั้ม

ชื่อศิลปินที่ผลิตอัลบั้ม ตัวอย่างเช่น ในอัลบั้มรวมเพลง เช่น ดีเจ ศิลปินอัลบั้มไม่จําเป็นต้องเหมือนกับศิลปินของแต่ละเพลงในอัลบั้ม ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyAlbumTitle

คีย์สตริง: ชื่ออัลบั้ม

ชื่ออัลบั้มที่มีแทร็กเพลงอยู่ ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyComposer

คีย์สตริง: Composer

ชื่อผู้ประพันธ์เพลงของแทร็กเพลง ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyDiscNumber

คีย์จํานวนเต็ม: หมายเลขดิสก์

จํานวนดิสก์ (นับจาก 1) ที่แทร็กเพลงอยู่ในอัลบั้มหลายดิสก์

- (NSString* const) kGCKMetadataKeyTrackNumber

คีย์จํานวนเต็ม: หมายเลขติดตาม

หมายเลขแทร็กของแทร็กเพลงในดิสก์อัลบั้ม โดยทั่วไปแล้ว หมายเลขแทร็กจะนับเริ่มต้นที่ 1 แต่ค่านี้อาจเป็น 0 หากเป็น "แทร็กที่ซ่อนอยู่" ในตอนต้นของอัลบั้ม

- (NSString* const) kGCKMetadataKeySeasonNumber

คีย์จํานวนเต็ม: หมายเลขซีซัน

หมายเลขซีซันที่มีตอนของรายการทีวี โดยปกติ หมายเลขซีซันจะเริ่มจาก 1 แต่ค่านี้อาจเป็น 0 หากเป็นตอน "นําร่อง" ที่กําหนดไว้ล่วงหน้าเพื่อเริ่มซีรีส์อย่างเป็นทางการ

- (NSString* const) kGCKMetadataKeyEpisodeNumber

คีย์จํานวนเต็ม: หมายเลขตอน

จํานวนตอนในซีซันหนึ่งๆ ของรายการทีวี ปกติแล้วหมายเลขตอนจะเริ่มจาก 1 แต่ค่านี้อาจเป็น 0 หากเป็นตอน "นําร่อง" ที่ไม่ถือว่าเป็นตอนอย่างเป็นทางการของซีซันแรก

- (NSString* const) kGCKMetadataKeySeriesTitle

คีย์สตริง: ชื่อชุดหนังสือ

ชื่อชุดหนังสือ ตัวอย่างเช่น อาจเป็นชื่อของรายการทีวีหรือชุดอัลบั้มเพลงที่เกี่ยวข้อง ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyStudio

คีย์สตริง: Studio

ชื่อสตูดิโอบันทึกเสียงที่ผลิตสื่อ 1 ชิ้น ตัวอย่างเช่น อาจเป็นชื่อสตูดิโอภาพยนตร์หรือค่ายเพลง ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyWidth

คีย์จํานวนเต็ม: ความกว้าง

ความกว้างของสื่อเป็นพิกเซล ซึ่งโดยทั่วไปแล้วจะนําไปใช้สําหรับระบุขนาดของรูปภาพ

- (NSString* const) kGCKMetadataKeyHeight

จํานวนเต็ม: ความสูง

ความสูงของสื่อ หน่วยเป็นพิกเซล ซึ่งโดยทั่วไปแล้วจะนําไปใช้สําหรับระบุขนาดของรูปภาพ

- (NSString* const) kGCKMetadataKeyLocationName

คีย์สตริง: ชื่อสถานที่ตั้ง

ชื่อสถานที่ที่มีการสร้างสื่อ ตัวอย่างเช่น อาจเป็นตําแหน่งของรูปภาพหรือสถานที่ถ่ายทําหลัก ค่านี้เหมาะสําหรับวัตถุประสงค์ในการแสดงผล

- (NSString* const) kGCKMetadataKeyLocationLatitude

Double key: ละติจูดของตําแหน่ง

องค์ประกอบละติจูดของสถานที่ทางภูมิศาสตร์ที่มีการสร้างสื่อขึ้น ตัวอย่างเช่น อาจเป็นตําแหน่งของรูปภาพหรือสถานที่ถ่ายทําหลัก

- (NSString* const) kGCKMetadataKeyLocationLongitude

คีย์คู่: ลองจิจูดของสถานที่

องค์ประกอบลองจิจูดของสถานที่ทางภูมิศาสตร์ที่มีการสร้างสื่อ ตัวอย่างเช่น อาจเป็นตําแหน่งของรูปภาพหรือสถานที่ถ่ายทําหลัก

รายละเอียดพร็อพเพอร์ตี้

- (GCKMediaMetadataType) metadataType

readnonatomicassign

ประเภทของข้อมูลเมตา

คลาส GCKMediaMetadata

ภาพรวม

สรุปเมธอดของอินสแตนซ์

แอตทริบิวต์สาธารณะ

สรุปพร็อพเพอร์ตี้

รายละเอียดเมธอด

เอกสารประกอบข้อมูลสมาชิก

รายละเอียดพร็อพเพอร์ตี้