نظرة عامة
تمثّل هذه السمة حاوية للبيانات الوصفية للوسائط.
تتضمن البيانات الوصفية نوع وسائط وقائمة صور اختيارية ومجموعة من حقول البيانات الوصفية. يتم تحديد مفاتيح حقول بيانات التعريف الشائعة مسبقًا كثوابت، ولكن يمكن للتطبيق تحديد واستخدام حقول إضافية خاصة به مجانًا.
تشتمل قيم الحقول المحدَّدة مسبقًا على أنواع محدّدة مسبقًا. على سبيل المثال، رقم المسار هو NSInteger
وتاريخ الإنشاء هو NSString يحتوي على تمثيل ISO-8601 للتاريخ والوقت. ستؤدي محاولة تخزين قيمة من نوع غير صحيح في حقل إلى ظهور NSInvalidArgumentException.
يُرجى ملاحظة أنّ بروتوكول Cast يفرض قيودًا على حقول البيانات الوصفية التي يمكن استخدامها لنوع معيّن من الوسائط. عندما يكون عنصر MediaMetadata تسلسليًا بتنسيق JSON لتسليمه إلى جهاز استقبال بث، فإن أي حقول محددة مسبقًا غير متوافقة مع نوع وسائط معين لن يتم تضمينها في النموذج المتسلسل، ولكن سيتم دائمًا تضمين أي حقول محددة للتطبيق. في ما يلي القائمة الكاملة للحقول المحدَّدة مسبقًا:
تكتسب NSObject و<NSCopying> و <NSSecureCoding>.
ملخّص طريقة المثيل | |
(instancetype) | - initWithMetadataType: |
تعمل هذه السياسة على إعداد بيانات وصفية جديدة وفارغة للوسائط الوصفية باستخدام نوع الوسائط المحدّد. المزيد... | |
(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 |
مفتاح السلسلة: 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 |
مفتاح مزدوج: خط طول الموقع الجغرافي المزيد... | |
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 |
تعمل هذه السياسة على إعداد بيانات وصفية جديدة وفارغة للوسائط الوصفية باستخدام نوع الوسائط المحدّد.
المُهيئ المُعيّن.
- 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 |
مفتاح السلسلة: 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 |
مفتاح مزدوج: خط طول الموقع الجغرافي
العنصر المكوِّن لخط الطول للموقع الجغرافي الذي تم فيه إنشاء جزء من الوسائط. على سبيل المثال، قد يكون ذلك الموقع الجغرافي لصورة فوتوغرافية أو الموقع الرئيسي لفيلم.
- (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
تفاصيل الموقع
|
readnonatomicassign |
تمثّل هذه السمة نوع البيانات الوصفية.