ภาพรวม
คอนเทนเนอร์สำหรับข้อมูลเมตาสื่อ
ข้อมูลเมตามีประเภทสื่อ รายการรูปภาพที่ไม่บังคับ และคอลเล็กชันของฟิลด์ข้อมูลเมตา คีย์สำหรับฟิลด์ข้อมูลเมตาทั่วไปจะกำหนดไว้ล่วงหน้าเป็นค่าคงที่ แต่แอปพลิเคชันสามารถกำหนดและใช้ฟิลด์เพิ่มเติมของตนเองได้
ค่าของช่องที่กำหนดไว้ล่วงหน้าจะมีประเภทที่กำหนดไว้ล่วงหน้า เช่น หมายเลขแทร็กคือ NSInteger และวันที่สร้างคือ NSString ที่มีการแสดงวันที่และเวลาในรูปแบบ ISO-8601 การพยายามจัดเก็บค่าประเภทที่ไม่ถูกต้องในช่องจะทำให้เกิด NSInvalidArgumentException
โปรดทราบว่าโปรโตคอล Cast จะจำกัดช่องข้อมูลเมตาที่ใช้ได้สำหรับสื่อประเภทหนึ่งๆ เมื่อมีการซีเรียลไลซ์ออบเจ็กต์ MediaMetadata เป็น JSON เพื่อส่งไปยังตัวรับ Cast ฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่รองรับสำหรับประเภทสื่อที่กำหนดจะไม่รวมอยู่ในรูปแบบที่ซีเรียลไลซ์ แต่ฟิลด์ที่แอปพลิเคชันกำหนดจะรวมอยู่เสมอ รายการฟิลด์ที่กำหนดไว้ล่วงหน้าทั้งหมดมีดังนี้
รับค่า 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 เพิ่มเติม... | |
| (double) | - doubleForKey: |
| อ่านค่าของฟิลด์ double เพิ่มเติม... | |
| (double) | - doubleForKey:defaultValue: |
| อ่านค่าของฟิลด์ double เพิ่มเติม... | |
| (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 |
| คีย์สตริง: Subtitle เพิ่มเติม... | |
| 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 |
| คีย์คู่: ละติจูดของสถานที่ตั้ง เพิ่มเติม... | |
| 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.
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์สตริง
| - (NSString *__nullable) stringForKey: | (NSString *) | key |
อ่านค่าของฟิลด์สตริง
- Parameters
-
key The key for the field.
- การคืนสินค้า
- ค่าของช่อง หรือ
nilหากไม่ได้ตั้งค่าช่อง
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์สตริง
| - (void) setInteger: | (NSInteger) | value | |
| forKey: | (NSString *) | key | |
จัดเก็บค่าในฟิลด์จำนวนเต็ม
- Parameters
-
value The new value for the field. key The key for the field.
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์จำนวนเต็ม
| - (NSInteger) integerForKey: | (NSString *) | key |
อ่านค่าของฟิลด์จำนวนเต็ม
- Parameters
-
key The key for the field.
- การคืนสินค้า
- ค่าของช่อง หรือ 0 หากไม่ได้ตั้งค่าช่อง
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์จำนวนเต็ม
| - (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.
- การคืนสินค้า
- ค่าของฟิลด์ หรือค่าเริ่มต้นที่ระบุหากไม่ได้ตั้งค่าฟิลด์
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์จำนวนเต็ม
| - (void) setDouble: | (double) | value | |
| forKey: | (NSString *) | key | |
จัดเก็บค่าในฟิลด์ double
- Parameters
-
value The new value for the field. key The key for the field.
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์ double
| - (double) doubleForKey: | (NSString *) | key |
อ่านค่าของฟิลด์ double
- Parameters
-
key The key for the field.
- การคืนสินค้า
- ค่าของช่อง หรือ 0 หากไม่ได้ตั้งค่าช่อง
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์ double
| - (double) doubleForKey: | (NSString *) | key | |
| defaultValue: | (double) | defaultValue | |
อ่านค่าของฟิลด์ double
- Parameters
-
defaultValue The value to return if the field has not been set. key The key for the field.
- การคืนสินค้า
- ค่าของฟิลด์ หรือค่าเริ่มต้นที่ระบุหากไม่ได้ตั้งค่าฟิลด์
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์ double
| - (void) setDate: | (NSDate *) | date | |
| forKey: | (NSString *) | key | |
จัดเก็บค่าในฟิลด์วันที่เป็นการแสดงวันที่แบบ ISO-8601 ที่จำกัด
- Parameters
-
date The new value for the field. key The key for the field.
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์วันที่
| - (NSDate *__nullable) dateForKey: | (NSString *) | key |
อ่านค่าของฟิลด์วันที่จากการแสดงวันที่แบบ ISO-8601 ที่จำกัด
- Parameters
-
key The field name.
- การคืนสินค้า
- วันที่ หรือ
nilหากไม่ได้ตั้งค่าช่องนี้
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์วันที่
| - (NSString *__nullable) dateAsStringForKey: | (NSString *) | key |
อ่านค่าของฟิลด์วันที่เป็นสตริง
- Parameters
-
key The field name.
- การคืนสินค้า
- วันที่เป็นสตริงที่มีการแสดงวันที่แบบ ISO-8601 ที่จำกัด หรือ
nilหากไม่ได้ตั้งค่าฟิลด์นี้
- ข้อยกเว้น
-
NSInvalidArgumentException หากคีย์อ้างอิงถึงฟิลด์ที่กำหนดไว้ล่วงหน้าซึ่งไม่ใช่ฟิลด์วันที่
เอกสารประกอบเกี่ยวกับข้อมูลสมาชิก
| - (NSString* const) kGCKMetadataKeyCreationDate |
คีย์สตริง: วันที่สร้าง
ค่าคือวันที่และ/หรือเวลาที่สร้างสื่อในรูปแบบ ISO-8601 เช่น วันที่และเวลาที่ถ่ายภาพหรือบันทึกเพลง
| - (NSString* const) kGCKMetadataKeyReleaseDate |
คีย์สตริง: วันที่เผยแพร่
ค่าคือวันที่และ/หรือเวลาที่เผยแพร่สื่อ ในรูปแบบ ISO-8601 เช่น วันที่ภาพยนตร์หรืออัลบั้มเพลงเปิดตัว
| - (NSString* const) kGCKMetadataKeyBroadcastDate |
คีย์สตริง: วันที่ออกอากาศ
ค่านี้คือวันที่และ/หรือเวลาที่ออกอากาศสื่อเป็นครั้งแรกในรูปแบบ ISO-8601 เช่น วันที่ที่ออกอากาศตอนของรายการทีวีเป็นครั้งแรก
| - (NSString* const) kGCKMetadataKeyTitle |
คีย์สตริง: ชื่อ
ชื่อสื่อ เช่น ชื่อเพลง ภาพยนตร์ หรือรายการทีวี ค่านี้เหมาะสําหรับการแสดง
| - (NSString* const) kGCKMetadataKeySubtitle |
คีย์สตริง: Subtitle
ชื่อรองของสื่อ ค่านี้เหมาะสําหรับการแสดง
| - (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
ชื่อสตูดิโอบันทึกเสียงที่ผลิตสื่อ เช่น อาจเป็นชื่อสตูดิโอภาพยนตร์หรือค่ายเพลง ค่านี้เหมาะสําหรับการแสดง
| - (NSString* const) kGCKMetadataKeyWidth |
คีย์จำนวนเต็ม: ความกว้าง
ความกว้างของสื่อในหน่วยพิกเซล โดยปกติจะใช้เพื่อระบุขนาดของภาพถ่าย
| - (NSString* const) kGCKMetadataKeyHeight |
คีย์จำนวนเต็ม: ความสูง
ความสูงของสื่อในหน่วยพิกเซล โดยปกติจะใช้เพื่อระบุขนาดของภาพถ่าย
| - (NSString* const) kGCKMetadataKeyLocationName |
คีย์สตริง: ชื่อสถานที่
ชื่อสถานที่ที่สร้างสื่อ เช่น อาจเป็นสถานที่ถ่ายภาพหรือสถานที่ถ่ายทำหลักของภาพยนตร์ ค่านี้เหมาะสําหรับการแสดง
| - (NSString* const) kGCKMetadataKeyLocationLatitude |
คีย์คู่: ละติจูดของสถานที่ตั้ง
องค์ประกอบละติจูดของสถานที่ตั้งทางภูมิศาสตร์ที่สร้างสื่อ เช่น อาจเป็นสถานที่ถ่ายภาพหรือสถานที่ถ่ายทำหลักของภาพยนตร์
| - (NSString* const) kGCKMetadataKeyLocationLongitude |
คีย์คู่: ลองจิจูดของตำแหน่ง
คอมโพเนนต์ลองจิจูดของสถานที่ตั้งทางภูมิศาสตร์ที่สร้างชิ้นงานสื่อ เช่น อาจเป็นสถานที่ถ่ายภาพหรือสถานที่ถ่ายทำหลักของภาพยนตร์
รายละเอียดพร็อพเพอร์ตี้
|
readnonatomicassign |
ประเภทข้อมูลเมตา