סקירה כללית

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

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

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

הערה: פרוטוקול ההעברה מגביל את שדות המטא-נתונים שניתן להשתמש בהם בסוג מדיה מסוים. כאשר אובייקט MediaMetadata בהסדרה של JSON ל-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. יישום <NSCopy>.

סיכום של שיטת המכונה
(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
	מפתח מחרוזת: מלחין. עוד...

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.

חריגים

חריגת ארגומנט NSInvalid אם המפתח מתייחס לשדה מוגדר מראש שהוא לא שדה מחרוזת.

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

קורא את הערך של שדה מחרוזת.

Parameters

key	The key for the field.

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

חריגים

חריגת ארגומנט NSInvalid אם המפתח מתייחס לשדה מוגדר מראש שהוא לא שדה מחרוזת.

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

מאחסנת ערך בשדה של מספר שלם.

Parameters

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

חריגים

חריגת ארגומנט NSInvalid אם המפתח מתייחס לשדה מוגדר מראש שאינו שדה מספר שלם.

- (NSInteger) integerForKey: (NSString *) key

קורא את הערך של שדה מספר שלם.

Parameters

key	The key for the field.

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

חריגים

חריגת ארגומנט NSInvalid אם המפתח מתייחס לשדה מוגדר מראש שאינו שדה מספר שלם.

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

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

חריגים

חריגת ארגומנט NSInvalid אם המפתח מתייחס לשדה מוגדר מראש שאינו שדה מספר שלם.

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

מאחסן ערך בשדה כפול.

Parameters

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

חריגים

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

- (double) doubleForKey: (NSString *) key

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

Parameters

key	The key for the field.

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

חריגים

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

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

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

חריגים

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

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

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

Parameters

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

חריגים

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

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

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

Parameters

key	The field name.

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

חריגים

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

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

קורא את הערך של שדה תאריך כמחרוזת.

Parameters

key	The field name.

החזרות: התאריך כמחרוזת המכילה את ייצוג ISO-8601 המוגבל של התאריך, או nil אם שדה זה לא הוגדר.

חריגים

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

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

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

מספר שלם: מספר דיסק.

מספר הדיסק (מספר אחד מתוך הטראק) שאליו שייכת טראק מוזיקה באלבום מרובה דיסקים.

- (NSString* const) kGCKMetadataKeyTrackNumber

מספר שלם: מספר למעקב.

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

- (NSString* const) kGCKMetadataKeySeasonNumber

מספר שלם: מספר עונה.

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

- (NSString* const) kGCKMetadataKeyEpisodeNumber

מספר שלם: פרק.

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

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

סקירה כללית

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

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

סיכום הנכס

פרטי השיטה

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

פרטי הנכס