مرجع إطار عمل MLKitDigitalInkRecognition

DigitalInkRecognitionModelIdentifier

class DigitalInkRecognitionModelIdentifier : NSObject

يمثّل نموذج التعرّف على الحبر الرقمي الخاص بلغة أو نص برمجي أو خيارًا إقليميًا.

• languageTag

  علامة اللغة المتوافقة مع BCP 47 لهذا النموذج.

  التعريف

  Swift

  var languageTag: String { get }

• languageSubtag

  علامة اللغة الفرعية، أي رمز اللغة ISO 639 المكوّن من 2 أو 3 أحرف لنموذج التعرّف هذا، مثل "en" للغة الإنجليزية.

  التعريف

  Swift

  var languageSubtag: String { get }

• scriptSubtag

  العلامة الفرعية للنص البرمجي، أي الرمز القياسي ISO 15924 المكون من أربعة أحرف للنص البرمجي المستخدَم في نموذج التعرّف هذا، مثل "Latn" للنص اللاتيني أو "Arab" للنص العربي.

  التعريف

  Swift

  var scriptSubtag: String? { get }

• regionSubtag

  علامة المنطقة الفرعية، أي رموز المناطق القياسية المكوّنة من حرفَين وفقًا لمعيار ISO 3166-1 Alpha 2 أو مجموعة الرموز الرقمية المحدّدة بموجب معيار الأمم المتحدة M.49، مثل "DE" لألمانيا أو "002" لأفريقيا.

  التعريف

  Swift

  var regionSubtag: String? { get }

• -init

  يمكنك استخدام from(languageTag:) كبديل.

• from(languageTag:)

  تعرض هذه الدالة معرّف نموذج يتطابق على أفضل نحو مع اللغة والنص البرمجي (إن توفَّر) والمنطقة (إن توفّرت) الذي تم ترميزه باستخدام languageTag بتنسيق BCP 47.

  وتتمثّل المطابقة بأفضل جهد، أي أنّها تعرض معرّف النموذج الذي يتطابق على أفضل نحو مع السمة languageTag المقدّمة باستخدام الأساليب الإرشادية التالية:

  إذا تعذّر العثور على معرّف نموذج للعلامة الفرعية المطلوبة للغة، لكنّ الأخيرة جزء من لغة ماكرو متوافقة، يمكنك المطابقة مع لغة الماكرو، على سبيل المثال، سيطابق "arb" (العربية العادية) "ar" (العربية).

  إذا لم يتم توفير أي نص برمجي ولم يتم تضمين نص برمجي في العلامة الفرعية للغة المطلوبة، يمكنك المطابقة مع أي نص برمجي.

  إذا كانت العلامة الفرعية للنص البرمجي المقدّمة أو الضمنية هي مجموعة فرعية من نص برمجي متوافق، يمكنك المطابقة مع العلامة الثانية أيضًا، على سبيل المثال، ستتم مطابقة "zh-Hant" (الصينية والهان التقليدية) مع "zh-Hani" (الصينية، هان).

  في حال عدم تحديد علامة فرعية للمنطقة، يجب إجراء مطابقة مع أي منطقة، مع تفضيل معرّفات النموذج التي لا تحدّد أيضًا منطقة، على سبيل المثال "ro" (الرومانية) ستتم مطابقتها مع "ro-RO" (الرومانية، رومانيا).

  إذا تم تحديد علامة فرعية لمنطقة معيّنة، ولكن تعذّرت مطابقتها مع المناطق التي تحتوي على المنطقة المحدّدة، ستتطابق مثلاً "fr-DZ" (الفرنسية والجزائر) مع "fr-002" (الفرنسية، أفريقيا).

  إذا لم يتم العثور على معرّف نموذج، سيتم عرض nil.

  التعريف

  Swift

  class func from(languageTag: String) throws -> DigitalInkRecognitionModelIdentifier

  المَعلمات

  languageTag	علامة لغة IETF BCP 47 تمثل اللغة المطلوبة.
  error	ستتم تعبئة كائن رسالة الخطأ الاختياري إذا تعذّر تحليل languageTag.

  القيمة المعروضة

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

• init(forLanguageTag:)

  تعرض معرّف نموذج يتطابق تمامًا مع سمة languageTag المحدّدة.

  تختلف عن from(LanguageTag:) في أنّها لا تحاول تحليل languageTag (وبالتالي لا تؤدي إلى ظهور أخطاء)، ولكنّها تعرض فقط معرّف النموذج الذي يتطابق مع languageTag تمامًا، إذا كان متوفّرًا.

  التعريف

  Swift

  /*not inherited*/ init?(forLanguageTag languageTag: String)

  المَعلمات

  languageTag

  تشير هذه السمة إلى علامة اللغة 47 لمجموعة مهندسي شبكة الإنترنت (IETF) لمعرّف النموذج المطلوب.

  القيمة المعروضة

  تمثّل هذه السمة DigitalInkRecognitionModelIdentifier مطابقة تمامًا للسمة languageTag المقدّمة، أو السمة nil في حال عدم العثور على أي سمة.

• allModelIdentifiers()

  لعرض مجموعة من جميع معرّفات النماذج المتاحة.

  التعريف

  Swift

  class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>

• modelIdentifiers(forLanguageSubtag:)

  تعرض مجموعة من معرّفات النموذج التي تتيح استخدام العلامة الفرعية للغة معيّنة.

  على سبيل المثال، بالنسبة إلى "en"، سيؤدي ذلك إلى عرض مجموعة من معرّفات النماذج التي تحتوي على enUs (الإنجليزية، الولايات المتحدة)، enUk (الإنجليزية، المملكة المتحدة)، enKe (الإنجليزية، كينيا)، وما إلى ذلك.

  إذا لم يتم العثور على أي معرّفات نموذج تتوافق مع العلامة الفرعية للغة، يتم عرض مجموعة فارغة.

  التعريف

  Swift

  class func modelIdentifiers(forLanguageSubtag languageSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>

  المَعلمات

  languageSubtag

  رمز لغة ISO 639 مكوّن من 2 أو 3 أحرف، مثل "en" للإنجليزية

  القيمة المعروضة

  وقد تكون مجموعة من معرّفات النماذج التي تتوافق مع سمة languageSubtag المقدّمة فارغة.

• modelIdentifiers(forScriptSubtag:)

  تعرض مجموعة من معرّفات النماذج التي تتوافق مع العلامة الفرعية للنص البرمجي المحدّد.

  على سبيل المثال، بالنسبة إلى "Latn"، سيؤدي ذلك إلى عرض مجموعة من معرّفات النماذج التي تحتوي على enUs (الإنجليزية والولايات المتحدة) وfrFr (الفرنسية وفرنسا) وguLatn (الغوجاراتية والنصوص اللاتينية) وما إلى ذلك.

  تعرض هذه الدالة أيضًا معرّفات النماذج التي تتيح مجموعة كاملة من العلامة الفرعية للنص البرمجي المحدّدة، مثل Hant (Han، الصيغة التقليدية)، ستعرض هذه الدالة نماذج التعرّف على zh-Hani، بما أنّ Hant هي مجموعة فرعية من Hani (هان، صيغتان تقليديتان ومبسّطتان معًا).

  إذا لم يتم العثور على أي معرّفات نموذج تدعم العلامة الفرعية للنص البرمجي، سيتم عرض مجموعة فارغة.

  التعريف

  Swift

  class func modelIdentifiers(forScriptSubtag scriptSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>

  المَعلمات

  scriptSubtag

  تمثّل هذه السمة رمز ISO 15924 عاديًا مكوَّنًا من أربعة أحرف، مثل "Latn" للنص اللاتيني أو "Arab" للنص العربي.

  القيمة المعروضة

  وقد تكون مجموعة من معرّفات النماذج التي تتوافق مع سمة scriptSubtag المقدّمة فارغة.

• modelIdentifiers(forRegionSubtag:)

  تعرض مجموعة من معرّفات النموذج الخاصة بالعلامة الفرعية للمنطقة المحدّدة.

  على سبيل المثال، بالنسبة إلى "CH"، سيؤدي ذلك إلى عرض مجموعة من معرّفات النماذج التي تحتوي على deCh (الألمانية وسويسرا) وfrCh (الفرنسية وسويسرا) وitCh (الإيطالية وسويسرا) وrmCh (الرومانية وسويسرا).

  تعرض هذه الدالة أيضًا معرّفات النموذج الخاصة بالمناطق التي تحتوي على العلامة الفرعية للمنطقة المحدّدة أو مضمّنة في العلامة الفرعية للمنطقة المحدّدة. مثلاً، سيؤدي البحث عن DZ (الجزائر) إلى الحصول على نتائج تتضمّن نموذج التعرّف fr-002 (بالفرنسية والأفريقي) والعكس صحيح.

  إذا لم يتم العثور على أي معرّفات نموذج تتوافق مع العلامة الفرعية للمنطقة، يتم عرض مجموعة فارغة.

  التعريف

  Swift

  class func modelIdentifiers(forRegionSubtag regionSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>

  المَعلمات

  regionSubtag

  تمثّل هذه السمة رمز المنطقة العادي المكوّن من حرفَين وفقًا لمعيار ISO 3166-1 Alpha 2 أو أحد الرموز الرقمية المحدّدة في معيار الأمم المتحدة M.49، مثل "DE" لألمانيا أو "002" لأفريقيا.

  القيمة المعروضة

  وقد تكون مجموعة من معرّفات النماذج الخاصة بسمة regionSubtag المقدَّمة فارغة.