סקירה כללית

מאגר למטא-נתונים של מדיה.

למטא נתונים יש סוג מדיה, רשימה אופציונלית של תמונות ואוסף של שדות מטא נתונים. מפתחות לשדות מטא-נתונים נפוצים מוגדרים מראש כקבועים, אבל באפליקציה אפשר להגדיר שדות נוספים משל עצמה ולהשתמש בהם בחינם.

לערכים של השדות המוגדרים מראש יש סוגים מוגדרים מראש. לדוגמה, מספר טראק הוא NSInteger ותאריך יצירה הוא NSString שמכיל ייצוג ISO-8601 של תאריך ושעה. ניסיון לאחסן ערך מסוג שגוי בשדה יגרום ל-NSInvalidArgumentException.

חשוב לזכור שפרוטוקול Cast מגביל את שדות המטא-נתונים שאפשר להשתמש בהם בסוג מדיה נתון. כאשר אובייקט MediaMetadata עובר סריאליזציה ל-JSON לצורך שליחה למקלט Cast, שדות מוגדרים מראש שלא נתמכים בסוג מדיה מסוים לא ייכללו בטופס בסדרה, אבל כל השדות שהוגדרו על ידי האפליקציה ייכללו תמיד. הרשימה המלאה של השדות המוגדרים מראש:

שדה	סוג הערך	סוגי מטא-נתונים חוקיים
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, <NS Copy> ו-<NSSecureCoding>.

סיכום שיטות של מכונה
(instancetype)	- initWithMetadataType:
	מפעיל MediaMetadata חדש, ריק עם סוג המדיה הנתון. עוד...

(instancetype)	- init
	מתחילים להפעיל באמצעות סוג המטא-נתונים הכללי. עוד...

(GCKMediaMetadataType)	- metadataType
	סוג המטא-נתונים. עוד...

(NSArray *)	- images
	קבלת רשימת התמונות. עוד...

(void)	- removeAllMediaImages
	הסרת כל התמונות הנוכחיות. עוד...

(void)	- addImage:
	הוספת תמונה לרשימת התמונות. עוד...

(BOOL)	- containsKey:
	בודקת אם האובייקט מכיל שדה עם המפתח הנתון. עוד...

(NSArray< NSString * > *)	- allKeys
	מחזירה קבוצה של מפתחות לכל השדות שנמצאים באובייקט. עוד...

(nullable id)	- objectForKey:
	קריאת הערך של שדה. עוד...

(void)	- setString:forKey:
	שומרת ערך בשדה מחרוזת. עוד...

(nullable NSString *)	- stringForKey:
	קורא את הערך של שדה מחרוזת. עוד...

(void)	- setInteger:forKey:
	שומרת ערך בשדה של מספר שלם. עוד...

(NSInteger)	- integerForKey:
	קריאת הערך של שדה מספר שלם. עוד...

(NSInteger)	- integerForKey:defaultValue:
	קריאת הערך של שדה מספר שלם. עוד...

(void)	- setDouble:forKey:
	שמירת ערך בשדה כפול. עוד...

(double)	- doubleForKey:
	קורא את הערך של שדה כפול. עוד...

(double)	- doubleForKey:defaultValue:
	קורא את הערך של שדה כפול. עוד...

(void)	- setDate:forKey:
	שמירת ערך בשדה תאריך כייצוג מוגבל של ISO-8601 של התאריך. עוד...

(nullable NSDate *)	- dateForKey:
	קורא את הערך של שדה תאריך מהייצוג המוגבל של ISO-8601 של התאריך. עוד...

(nullable NSString *)	- 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
	מפתח מחרוזת: מלחין. עוד...

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
	מקש כפול: קו אורך של המיקום. עוד...

NSString *const	kGCKMetadataKeyBookTitle
	מפתח מחרוזת: שם הספר. עוד...

NSString *const	kGCKMetadataKeyChapterNumber
	מפתח מספר שלם: מספר הפרק. עוד...

NSString *const	kGCKMetadataKeyChapterTitle
	מפתח מחרוזת: שם הפרק. עוד...

NSString *const	kGCKMetadataKeySectionDuration
	מקש כפול: משך הקטע. עוד...

NSString *const	kGCKMetadataKeySectionStartTimeInMedia
	מקש כפול: שעת ההתחלה של הקטע במדיה. עוד...

NSString *const	kGCKMetadataKeySectionStartAbsoluteTime
	מקש כפול: זמן התחלה מוחלט לקטע. עוד...

NSString *const	kGCKMetadataKeySectionStartTimeInContainer
	מקש כפול: שעת ההתחלה של הקטע בכלי הקיבול. עוד...

NSString *const	kGCKMetadataKeyQueueItemID
	מקש כפול: מזהה פריט בתור. עוד...

סיכום הנכס
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

מחזירה קבוצה של מפתחות לכל השדות שנמצאים באובייקט.

- (nullable id) 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 אם המפתח מפנה לשדה מוגדר מראש שאינו שדה מחרוזת.

- (nullable NSString *) 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

שמירת ערך בשדה כפול.

Parameters

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

חריגים

NSInvalidArgumentException אם המפתח מפנה לשדה מוגדר מראש שאינו שדה כפול.

- (double) doubleForKey: (NSString *) key

קורא את הערך של שדה כפול.

Parameters

key	The key for the field.

החזרות: הערך בשדה הזה, או 0 אם השדה לא הוגדר.

חריגים

NSInvalidArgumentException אם המפתח מפנה לשדה מוגדר מראש שאינו שדה כפול.

- (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.

החזרות: הערך של השדה, או ערך ברירת המחדל הנתון אם השדה לא הוגדר.

חריגים

NSInvalidArgumentException אם המפתח מפנה לשדה מוגדר מראש שאינו שדה כפול.

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

שמירת ערך בשדה תאריך כייצוג מוגבל של ISO-8601 של התאריך.

Parameters

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

חריגים

NSInvalidArgumentException אם המפתח מפנה לשדה מוגדר מראש שאינו שדה תאריך.

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

קורא את הערך של שדה תאריך מהייצוג המוגבל של ISO-8601 של התאריך.

Parameters

key	The field name.

החזרות: התאריך או nil אם השדה הזה לא הוגדר.

חריגים

NSInvalidArgumentException אם המפתח מפנה לשדה מוגדר מראש שאינו שדה תאריך.

- (nullable NSString *) 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

מפתח מחרוזת: כתובית.

כותרת המשנה של המדיה. הערך הזה מתאים למטרות תצוגה.

- (NSString* const) kGCKMetadataKeyArtist

מפתח מחרוזת: אומן.

שם האומן שיצר את המדיה. לדוגמה, השם יכול להיות מוזיקאי, אמן או צלם. הערך הזה מתאים למטרות תצוגה.

- (NSString* const) kGCKMetadataKeyAlbumArtist

מפתח מחרוזת: אומן האלבום.

שם האומן שהפיק את האלבום. לדוגמה: באלבומי אוסף כגון מיקסים של תקליטנים, האומן שמבצע את האלבום לא בהכרח זהה לאומן או לאומנים של כל אחד מהשירים הספציפיים באלבום. הערך הזה מתאים למטרות תצוגה.

- (NSString* const) kGCKMetadataKeyAlbumTitle

מפתח מחרוזת: שם האלבום.

שם האלבום שאליו שייכת טראק המוזיקה. הערך הזה מתאים למטרות תצוגה.

- (NSString* const) kGCKMetadataKeyComposer

מפתח מחרוזת: מלחין.

שם המלחין של טראק מוזיקה. הערך הזה מתאים למטרות תצוגה.

- (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

מקש כפול: קו אורך של המיקום.

רכיב קו האורך של המיקום הגיאוגרפי שבו נוצר קטע המדיה. לדוגמה, המיקום הזה יכול להיות המיקום של תמונה או המיקום העיקרי של סרט.

- (NSString* const) kGCKMetadataKeyBookTitle

מפתח מחרוזת: שם הספר.

שם של ספר אודיו.

מאז: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterNumber

מפתח מספר שלם: מספר הפרק.

מספר הפרק בספר אודיו.

מאז: 4.3.5

- (NSString* const) kGCKMetadataKeyChapterTitle

מפתח מחרוזת: שם הפרק.

שם הפרק בספר האודיו.

מאז: 4.3.5

- (NSString* const) kGCKMetadataKeySectionDuration

מקש כפול: משך הקטע.

משך הקטע בשניות. משמש למטא-נתונים של 'הבאים בתור'. לדוגמה: משך הזמן של תוכנית טלוויזיה אחת בתור, פרק מתוך ספר אודיו או תוכנית של שידור חי ארוך.

מאז: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

מקש כפול: שעת ההתחלה של הקטע במדיה.

ההיסט של שעת ההתחלה של הקטע מתחילת פריט המדיה בשניות. משמש למטא-נתונים של 'הבאים בתור'.

מאז: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

מקש כפול: זמן התחלה מוחלט לקטע.

הזמן המוחלט של תחילת הקטע, הזמן של מערכת בשניות. משמש למטא-נתונים של 'הבאים בתור'.

מאז: 4.4.1

- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

מקש כפול: שעת ההתחלה של הקטע בכלי הקיבול.

ההיסט של שעת ההתחלה של הקטע בתוך המאגר המלא. משמש למטא-נתונים של 'הבאים בתור'.

מאז: 4.4.1

- (NSString* const) kGCKMetadataKeyQueueItemID

מקש כפול: מזהה פריט בתור.

המזהה של הפריט בתור שכולל את שעת ההתחלה של הקטע. משמש למטא-נתונים של 'הבאים בתור'.

מאז: 4.4.1

פרטי הנכס

- (GCKMediaMetadataType) metadataType

readnonatomicassign

סוג המטא-נתונים.

כיתה GCKMediaMetadata

סקירה כללית

סיכום שיטות של מכונה

מאפיינים ציבוריים

סיכום הנכס

פרטי השיטה

תיעוד בנושא נתוני חברים

פרטי הנכס