סקירה כללית

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

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

לערכים של השדות המוגדרים מראש יש סוגים מוגדרים מראש. לדוגמה, מספר טראק הוא 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	‫double	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	‫double	GCKMediaMetadataTypePhoto

המחלקות האלה יורשות מ-NSObject. ‫Implements <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

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

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

פרטי הנכס

- (GCKMediaMetadataType) metadataType

readnonatomicassign

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

כיתה GCKMediaMetadata קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

סקירה כללית

סיכום שיטות המופע

מאפיינים גלויים לכולם

סיכום הנכס

פרטי השיטה

מסמכי מידע על נתוני חברים

פרטי הנכס

כיתה GCKMediaMetadata