حزم الأصوات المخصصة — كيفية بناء واستيراد حزمتك الخاصة

يمكن لتطبيق Vigilant Ear تعلّم أصوات جديدة. حزمة أصوات مخصصة تعلّم التطبيق التعرّف على أصوات لا يعرفها كاشف Apple المدمج — طيور منطقتك المحلية، آلة معيّنة في العمل، جرس الممر الغريب في مبنانك. تدرّب نموذجًا صغيرًا على Mac (لا حاجة للبرمجة)، وتضغطه مع ملفي نص صغيرين، ثم تستورده على iPhone.

الحزم المخصصة تتراكم فوق الكاشف المدمج. تفعيل حزمة لا يوقف أي شيء آخر أبدًا — تظل صفارات الإنذار وأجهزة الإنذار وكل صوت سلامة آخر يعمل تمامًا كما كان.

ستحتاج إلى: Mac مع تطبيق Create ML من Xcode (مجاني)، تسجيلات صوتية لأصواتك، وPower Pack+ على iPhone (التجربة المجانية تُحسب).

متطلبات صارمة — طبّقها بدقة تامة

حزمة تتجاهل أيًا من هذه ستُستورد لكنها تتصرف بشكل سيئ (تنبيهات كاذبة مستمرة، أو لا يُكتشف شيء). هذه ليست اقتراحات:

1. ضمّن فئة Background — إلزامية، وليست اختيارية. يجب أن يحتوي نموذجك على فئة مدرَّبة على بيئاتك المحيطة الحقيقية (غرفة هادئة، شارع، تشغيل المروحة). املأها بـ 15+ تسجيلًا حقيقيًا وعلّمها بـ "category": "ignored" و "threshold": 1.1 في profiles.json. بدون فئة Background ستُطلق حزمتك تنبيهات باستمرار على الصمت — يُجبر مصنّف الصوت على اختيار إحدى فئاته لكل لحظة صوتية، فبدون «دلو» لـ «لا شيء من هذه» يُصنّف غرفتك الهادئة كأقرب ما يشبهها.
2. اقتطع الصمت من مقاطع التدريب. مقطع مُسمّى "Owl" مدته 20 ثانية من الصمت مع نعيق واحد يعلّم النموذج أن الصمت بومة. اقتطع المقاطع بإحكام حول الصوت المستهدف، وإلا يتعلّم النموذج الفجوات.
3. سمِّ ملف النموذج بالضبط model.mlmodel أو model.mlpackage. أي اسم آخر → يفشل الاستيراد.
4. استخدم نموذج Create ML من نوع Sound Classification. تُرفض نماذج الصور/النص/الجداول.
5. مفاتيح profiles.json يجب أن تطابق تسميات فئات النموذج تمامًا — أي أسماء مجلدات التدريب، بما في ذلك حالة الأحرف والشرطات السفلية.
6. أضف gateClasses (انظر أدناه). بدونها، سيُطلق الموسيقى والتلفزيون الحزمة. هذا هو أكبر عامل تحكم في الإنذارات الكاذبة.
7. اضغط الملفات على المستوى الأعلى (أو داخل مجلد واحد — بلا أعماق أكثر). يجب أن يكون pack.json قابلاً للعثور عليه.
8. وازن فئاتك. لا تعطِ فئة 100 مقطعًا وأخرى 10 — سيميل النموذج نحو الأكبر. قلّل الفئات ذات العينات الكثيرة بحيث تبقى الأعداد ضمن ~3× من بعضها.

بقية هذا الدليل تمرّ على كل نقطة بالترتيب.

الخطوة 1 — اجمع صوت التدريب

أنشئ مجلدًا لكل صوت تريد التعرّف عليه، مسمّى بذلك الصوت، واملأه بتسجيلات أمثلة:

TrainingData/
  Mourning_Dove/        ← 20+ clips of mourning doves
  House_Finch/          ← 20+ clips of house finches
  Background/           ← 20+ clips of your ambient environment WITHOUT the sounds

نصائح تحدث فرقًا حقيقيًا:

• ضمّن دائمًا فئة Background. يجب أن يُسمّي النموذج كل لحظة صوتية بشيء ما — بدون فئة خلفية، يُدفع الصمت وضوضاء الشارع إلى فئاتك الحقيقية وسترى تنبيهات كاذبة. سجّل الأماكن التي ستستخدم فيها الحزمة فعليًا: حديقتك، أرضية ورشتك، مطبخك.
• أسماء المجلدات تصبح التسميات التي يعرضها التطبيق (الشرطات السفلية تتحول إلى مسافات: Mourning_Dove → "Mourning Dove"). يمكنك تجاوز أسماء العرض لاحقًا في profiles.json.
• التنوّع أهم من الطول: مسافات مختلفة، أوقات من اليوم، وظروف خلفية مختلفة. مقاطع بضع ثوانٍ لكل منها مناسبة.
• الصيغ الشائعة تعمل (.m4a، .wav، .mp3، .aiff).

الخطوة 2 — درّب النموذج في Create ML

1. افتح Create ML (على Mac مع Xcode: قائمة Xcode → Open Developer Tool → Create ML)، وأنشئ مشروع Sound Classification جديد.
2. اسحب مجلد TrainingData إلى Training Data.
3. انقر Train. بضع مئات من المقاطع تُدرَّب خلال دقائق.
4. راجع تبويب الدقة — إذا سجّلت فئة نتائج ضعيفة، فهي تحتاج مقاطع أكثر أو أكثر تنوّعًا.
5. في تبويب Output، انقر Get واحفظ النموذج باسم model.mlmodel (أو model.mlpackage — كلاهما يعمل). يجب أن يكون اسم الملف بالضبط model.mlmodel أو model.mlpackage.

الخطوة 3 — اكتب pack.json

بيان صغير يصف الحزمة:

{
  "id": "com.example.pack.socalbirds",
  "name": "SoCal Birder's Companion",
  "version": "1.0",
  "author": "Your Name",
  "classes": ["Mourning_Dove", "House_Finch", "Background"],
  "gateClasses": ["bird", "bird_vocalization", "bird_chirp_tweet", "pigeon_dove_coo", "crow_caw"]
}

• name مطلوب — هو ما يظهر في قائمة الحزم في التطبيق.
• id يعرّف الحزمة للتحديثات: إعادة استيراد حزمة بنفس id تستبدل النسخة القديمة في مكانها. أي سلسلة فريدة بأسلوب reverse-DNS تعمل.
• classes للتوثيق فقط. يقرأ التطبيق قائمة الفئات الحقيقية من النموذج نفسه، لذا عدم التطابق لن يكسر شيئًا (يُسجَّل فقط في السجل).
• gateClasses (اختياري، مُوصى به بشدة) هو الأداة الأكثر فاعلية لإيقاف الإيجابيات الكاذبة. انظر أدناه.

gateClasses — دع نموذج Apple يكون حارسك

نموذجك متخصص: جيد في تمييز أي من أصواتك يسمعه، لكنه لا يعرف ما هو «ليس أحد أصواتي» (هنا تساعد فئة Background). مصنّف Apple المدمج عام مدرَّب على ~300 صوت يومي — وهو ممتاز في السؤال الخشن «هل هناك طائر أصلًا؟»

gateClasses يربطهما: لا تُبلَّغ اكتشافات حزمتك إلا عندما يكون نموذج Apple يسمع في الوقت نفسه إحدى الفئات المدمجة المدرجة. حزمة طيور تُفلتر على تسميات طيور Apple، فإذا لم يعتقد Apple أن هناك طائرًا، تبقى حزمتك صامتة — مهما كانت ثقتها. هذا السطر الواحد يقضي على الغالبية العظمى من إنذارات الموسيقى والتلفزيون والغرفة الهادئة الكاذبة، لأن نموذج Apple يقيّم تلك أقل بكثير من البوابة. احذفه وتعمل الحزمة بلا بوابة (مناسب للاختبار، ثرثار في العالم الحقيقي).

البوابة متاحة فقط عندما يكون لدى Apple فئة قريبة من صوتك. إذا كانت حزمتك لشيء لا يعرفه نموذج Apple ذو ~300 فئة — آلة مصنع معيّنة، صفير جهاز طبي، جرس باب مخصص — فلا توجد تسمية مدمجة للفلترة عليها، فاترك gateClasses فارغًا وتعمل الحزمة بلا بوابة. هذا متوقع، وليس خطأ. لتلك الحزم تصبح فئة Background ليست دفاعًا واحدًا بين عدة بل الشيء الوحيد الذي يقف بينك وبين التنبيهات الكاذبة المستمرة — فاستثمر فيها بقوة (كثير من تسجيلات البيئة المحيطة الحقيقية) وارفع عتبات كل فئة.

فلتر حزمة طيور على تسميات طيور Apple العامة إضافة إلى أي تسميات محددة يمكن لنموذجك تسميتها فعليًا: bird، fowl، bird_vocalization، bird_chirp_tweet، bird_squawk، bird_flapping — وإذا كانت حزمتك تحتوي الأنواع المطابقة، crow_caw و pigeon_dove_coo. أنواع الحزم الأخرى تختار بواباتها من القائمة الكاملة لمعرّفات الأصوات المدمجة في الملحق أدناه — مثلًا حزمة سلالات كلاب تُفلتر على dog_bark/dog_howl، وحزمة مركبات على engine/truck.

muteClasses — فوّض إلى Apple في الأصوات التي لا يستطيع نموذجك تسميتها

gateClasses يفتح حزمتك عندما يعتقد Apple أن هناك طائرًا. لكن Apple يمكنه تحديدًا تسمية بعض الطيور التي قد لا يغطيها نموذجك — بطة، إوزة، بومة، ديك رومي، دجاجة، أو ديك. إذا سمع Apple بطة وليس لدى حزمتك فئة بطة، سيفرض نموذجك تصنيف ذلك البطّة إلى أقرب نوع ويستدعيها بثقة الطائر الخطأ. هذا خطأ تعريف، وليس إنذارًا كاذبًا من الصمت — وgateClasses وحده لن يوقفه، لأن البطة تُفعّل أيضًا بوابة bird العامة.

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

"muteClasses": ["owl_hoot", "duck_quack", "goose_honk", "turkey_gobble", "chicken", "chicken_cluck", "rooster_crow"]

قاعدة عامة: تسمية طائر Apple محددة تذهب إلى gateClasses إذا كان لدى نموذجك فئة مطابقة (أو أفضل) لها، وإلى muteClasses إذا لم يكن. كل ما يستطيع Apple تسميته وأنت لا تستطيع → اكتمه، ودع Apple يكون على حق.

الخطوة 4 — اكتب profiles.json (اختياري، مُوصى به)

يتحكم هذا في كيف يبدو ويُحسّ كل صوت في التطبيق — إدخال واحد لكل فئة، بمفتاح الاسم الدقيق للمجلد/التسمية:

{
  "Mourning_Dove": {
    "displayName": "Mourning Dove",
    "hapticCount": 1,
    "emergencyTier": "none",
    "category": "animal",
    "icon": "bird",
    "color": "teal",
    "threshold": 0.5,
    "maxRange": 150
  },
  "House_Finch": {
    "displayName": "House Finch",
    "hapticCount": 1,
    "category": "animal",
    "icon": "bird"
  },
  "Background": {
    "category": "ignored",
    "threshold": 1.1
  }
}

كل مفتاح اختياري — احذف أي شيء ويُطبَّق افتراضي معقول:

فئة Background لديك تحتاج الإدخال الخاص الموضّح أعلاه: "threshold": 1.1 يجعل من المستحيل الإبلاغ عنها (الثقة لا تتجاوز 1.0 أبدًا)، فتمتص الصوت المحيط بصمت بدل أن تظهر ككشف. لا تحذفها فقط — فئة غير مدرجة ما زالت تحصل على عتبة 0.5 الافتراضية وستظهر في التطبيق كصوت عام.

الخطوة 5 — اضغط الحزمة

حدّد الملفات الثلاثة — pack.json، profiles.json، model.mlmodel — انقر بزر الماوس الأيمن، وCompress. ضغط المجلد الحاوي بدلًا من ذلك يعمل أيضًا؛ يبحث التطبيق مجلدًا واحدًا عمقًا.

MyPack.zip
├── pack.json
├── profiles.json
└── model.mlmodel

أوصل الملف المضغوط إلى iPhone بأي طريقة تريد: AirDrop، iCloud Drive، Mail، Messages.

الخطوة 6 — الاستيراد على iPhone

1. افتح Vigilant Ear → قائمة الترس → Power Pack+.
2. مرّر إلى Custom Sound Packs (BYOM) وانقر Import Custom Pack (.zip).
3. اختر ملفك المضغوط في متصفح Files.

تظهر الحزمة في القائمة مع عدد أصواتها، وهي LIVE بالفعل. من هنا يمكنك:

• LIVE / OFF — تبديل الحزمة دون حذفها. الإيقاف لا يستهلك بطارية.
• Delete — يبدأ عدًا تنازليًا 5 ثوانٍ (انقر مرة أخرى للإلغاء)، ثم يزيل الحزمة بالكامل.
• استورد ما تشاء من الحزم؛ كلها تعمل جنبًا إلى جنب مع الكاشف المدمج. كل حزمة live إضافية تستهلك بعض البطارية، فأوقف الحزم التي لا تستخدمها.

تظهر الأصوات المكتشفة كأي صوت آخر: نقطة على الخريطة بأيقونتك ولونك، اسم العرض في التنبيهات، والاهتزازات التي ضبطتها.

سلوكان مدمجان يجدر معرفتهما: اكتشافات الحزم المخصصة لا تُرحَّل إلى أقران شبكة Constellation (الهواتف الأخرى لن تملك حزمتك)، وأصوات الحزم تتطلب كشفين متتاليين قبل التنبيه، مما يصفّي الإيجابيات الكاذبة لإطار واحد.

استكشاف الأخطاء

تحديث حزمة

أعد التدريب أو التعديل، أعد الضغط، واستورد مرة أخرى بنفس id في pack.json — تُستبدل النسخة القديمة في مكانها.

الملحق: معرّفات الأصوات المدمجة (iOS 26.5)

هذه فئات الأصوات المدمجة التي يستطيع مصنّف Sound Analysis على الجهاز من Apple التعرّف عليها — التسميات المتاحة لـ gateClasses و muteClasses أعلاه. لم تعد Apple تنشر هذه القائمة على موقع المطوّرين، لذا قُرئت الجدول أدناه مباشرة من المصنّف على الجهاز (SNClassifierIdentifier.version1).

التصنيفات المعروفة اعتبارًا من يوليو 2026 (iOS 26.5) — 303 تسمية. يمكن لـ Apple إضافة أو إزالة أو إعادة تسمية هذه في أي تحديث للنظام، فتعامل مع هذا كلقطة زمنية: الفلترة على تسمية يسقطها نظام مستقبلي تعني ببساطة أن تلك البوابة لا تُطلق أبدًا (حزمتك تبقى صامتة)، وتسمية مضافة حديثًا لن توجد حتى تفلتر عليها. استخدم التهجئة الدقيقة المعروضة (أحرف صغيرة، شرطات سفلية).

© 2026 Wingdings, Inc.
All rights reserved.
Patent Pending