نظرة عامة

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

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

تتضمّن قيم الحقول المحدّدة مسبقًا أنواعًا محدّدة مسبقًا. على سبيل المثال، رقم المسار هو 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. تنفيذ <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. المزيد...

(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

تخزِّن هذه السمة قيمة في حقل مزدوج.

Parameters

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

الاستثناءات

NSInvalidArgumentException إذا كان المفتاح يشير إلى حقل محدّد مسبقًا وليس حقل مزدوج

- (double) doubleForKey: (NSString *) key

تقرأ هذه الدالة قيمة حقل double.

Parameters

key	The key for the field.

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

الاستثناءات

NSInvalidArgumentException إذا كان المفتاح يشير إلى حقل محدّد مسبقًا وليس حقل مزدوج

- (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 إذا كان المفتاح يشير إلى حقل محدّد مسبقًا وليس حقل مزدوج

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