نظرة عامة

تمثل هذه الخاصية حاوية للبيانات الوصفية للوسائط.

تشتمل البيانات الوصفية على نوع وسائط وقائمة اختيارية من الصور ومجموعة من حقول البيانات الوصفية. يتم تحديد المفاتيح لحقول البيانات الوصفية الشائعة بشكل ثابت كثوابت، ولكن يكون للتطبيق حرية تحديد واستخدام حقول إضافية خاصة به.

تشتمل قيم الحقول المحددة مسبقًا على أنواع محددة مسبقًا. على سبيل المثال، رقم المقطع الصوتي هو NSInteger وتاريخ الإنشاء هو NSString يحتوي على تمثيل ISO-8601 لتاريخ ووقت. وستؤدي محاولة تخزين قيمة لنوع غير صحيح في أحد الحقول إلى ظهور NSinvalidArgumentException.

لاحظ أن بروتوكول الإرسال يحد من حقول البيانات الوصفية التي يمكن استخدامها لنوع وسائط معين. عندما يتم تسلسل عنصر MediaMetadata إلى JSON للتسليم إلى جهاز استقبال البث، لن يتم تضمين أي حقول محددة مسبقًا، وهي غير متوافقة مع نوع معين من الوسائط، في النموذج المتسلسل، ولكن سيتم دائمًا تضمين أي حقول محددة في التطبيق. في ما يلي القائمة الكاملة بالحقول المحددة مسبقًا:

الحقل	نوع القيمة	أنواع البيانات الوصفية الصالحة
kGCKMetadataKeyCreationDate	NSDate	GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate	NSDate	GCKMediaMetadataTypeGeneric وGCKMediaMetadataTypeMovie وGCKMediaMetadataTypeTVShow وGCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate	NSDate	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle	سلسلة NS	GCKMediaMetadataTypeGeneric وGCKMediaMetadataTypeMovie وGCKMediaMetadataTypeTVShow وGCKMediaMetadataTypeMusicTrack وGCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle	سلسلة NS	GCKMediaMetadataTypeGeneric، GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist	سلسلة NS	GCKMediaMetadataTypeGeneric وGCKMediaMetadataTypeMusicTrack وGCKMediaMetadataTypePhoto
kGCKMetadataKeyAlbumArtist	سلسلة NS	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyAlbumTitle	سلسلة NS	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyComposer	سلسلة NS	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyDiscNumber	عدد صحيح	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyTrackNumber	عدد صحيح	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeySeasonNumber	عدد صحيح	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyEpisodeNumber	عدد صحيح	GCKMediaMetadataTypeTVShow
kGCKMetadataKeySeriesTitle	سلسلة NS	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyStudio	سلسلة NS	GCKMediaMetadataTypeMovie
kGCKMetadataKeyWidth	عدد صحيح	GCKMediaMetadataTypePhoto
kGCKMetadataKeyHeight	عدد صحيح	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationName	سلسلة NS	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
	String key: Subtitle. المزيد...

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.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل محدد مسبقًا لا يمثل حقل سلسلة.

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

قراءة قيمة حقل سلسلة.

Parameters

key	The key for the field.

المرتجعات: قيمة الحقل، أو nil إذا لم يتم تعيين الحقل.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل محدد مسبقًا لا يمثل حقل سلسلة.

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

لتخزين قيمة في حقل عدد صحيح.

Parameters

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

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل محدد مسبقًا لا يمثل حقل عدد صحيح.

- (NSInteger) integerForKey: (NSString *) key

قراءة قيمة حقل عدد صحيح.

Parameters

key	The key for the field.

المرتجعات: قيمة الحقل، أو 0 إذا لم يتم تعيين الحقل.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل محدد مسبقًا لا يمثل حقل عدد صحيح.

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

المرتجعات: قيمة الحقل أو القيمة الافتراضية المحددة إذا لم يتم تعيين الحقل.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل محدد مسبقًا لا يمثل حقل عدد صحيح.

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

لتخزين قيمة في حقل مزدوج.

Parameters

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

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل مسبق التحديد وهو ليس حقلاً مزدوجًا.

- (double) doubleForKey: (NSString *) key

قراءة قيمة حقل مزدوج

Parameters

key	The key for the field.

المرتجعات: قيمة الحقل، أو 0 إذا لم يتم تعيين الحقل.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل مسبق التحديد وهو ليس حقلاً مزدوجًا.

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

المرتجعات: قيمة الحقل أو القيمة الافتراضية المحددة إذا لم يتم تعيين الحقل.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل مسبق التحديد وهو ليس حقلاً مزدوجًا.

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

تخزّن قيمة في حقل التاريخ كتمثيل ISO-8601 مقيّد للتاريخ.

Parameters

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

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل مسبق التحديد وهو ليس حقل تاريخ.

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

لقراءة قيمة أحد حقول التاريخ من تمثيل ISO-8601 المقيّد للتاريخ.

Parameters

key	The field name.

المرتجعات: التاريخ، أو nil إذا لم يتم تعيين هذا الحقل.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل مسبق التحديد وهو ليس حقل تاريخ.

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

قراءة قيمة حقل التاريخ كسلسلة.

Parameters

key	The field name.

المرتجعات: التاريخ كسلسلة تحتوي على تمثيل ISO-8601 مقيّد للتاريخ، أو nil إذا لم يتم ضبط هذا الحقل.

الاستثناءات

استثناء NSغير صالح إذا كان المفتاح يشير إلى حقل مسبق التحديد وهو ليس حقل تاريخ.

وثائق بيانات العضو

- (NSString* const) kGCKMetadataKeyCreationDate

مفتاح السلسلة: تاريخ الإنشاء.

تكون القيمة هي التاريخ و/أو الوقت الذي تم إنشاء الوسائط فيه، بالتنسيق ISO-8601. على سبيل المثال، يمكن أن يكون هذا التاريخ والوقت الذي تم فيه التقاط صورة فوتوغرافية أو تسجيل مقطع موسيقي.

- (NSString* const) kGCKMetadataKeyReleaseDate

مفتاح السلسلة: تاريخ الإصدار.

تكون القيمة هي التاريخ و/أو الوقت الذي تم فيه إطلاق الوسائط، بالتنسيق ISO-8601. على سبيل المثال، قد يكون هذا التاريخ هو تاريخ إطلاق فيلم أو ألبوم موسيقي.

- (NSString* const) kGCKMetadataKeyBroadcastDate

مفتاح السلسلة: تاريخ البث.

تكون القيمة هي التاريخ و/أو الوقت الذي تم فيه بث الوسائط لأول مرة، بالتنسيق ISO-8601. على سبيل المثال، قد يكون هذا التاريخ هو أول حلقة من بث لبرنامج تلفزيوني.

- (NSString* const) kGCKMetadataKeyTitle

مفتاح السلسلة: العنوان.

تمثّل هذه السمة عنوان الوسائط. على سبيل المثال، قد يكون عنوان أغنية أو فيلم أو حلقة من برنامج تلفزيوني. هذه القيمة مناسبة لأغراض العرض.

- (NSString* const) kGCKMetadataKeySubtitle

String key: Subtitle.

العنوان الفرعي للوسائط. هذه القيمة مناسبة لأغراض العرض.

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

المفتاح المزدوج: خط طول الموقع.

مكوّن خط الطول للموقع الجغرافي حيث تم إنشاء جزء من الوسائط. على سبيل المثال، قد يكون موقع التصوير الفوتوغرافي أو موقع التصوير الرئيسي للفيلم.

تفاصيل العقار

- (GCKMediaMetadataType) metadataType

readnonatomicassign

نوع البيانات الوصفية.

فئة GCKMediaMetadata

نظرة عامة

ملخص طريقة المثيل

السمات العامة

ملخص الموقع

تفاصيل الطريقة

وثائق بيانات العضو

تفاصيل العقار