ابدأ من هنا
ما يقدّمه TajweedFormer V4 للتطبيق، والطريقة المختصرة من تسجيل الدخول إلى نسخة تعمل.
نموذج TajweedFormer V4 يسمع تلاوة القرآن. يعمل داخل تطبيقك على جهاز المتعلّم، ويُرجع ما سمعه: كل صوت مع توقيته ودرجة الثقة فيه، ومخرجات منفصلة للمدّ والتشديد والغنّة والقلقلة.
الـ SDK محرّك استدلال. وهو لا يحكم على التلاوة، وتطبيقك يبني ملاحظاته الخاصة على مخرجات النموذج.
هناك أربع حزم SDK تشترك في بنية واحدة: Android، و Apple (iOS و macOS)، والويب، و Windows و Linux. وهي مجانية، وشيفرتها المصدرية متاحة للجميع على GitHub.
الطريقة المختصرة
- احصل على الوصول. سجّل الدخول في sdk.quranlab.ai بحسابك على Hugging Face، واقبل الترخيص، وأخبرنا بما تبنيه. يستغرق ذلك دقيقة تقريبًا، وتُقبل معظم الطلبات على الفور.
- انسخ نصّ تعليمات واحدًا. في صفحتك الرئيسية زر «انسخ التعليمات». الصق التعليمات في مساعدك البرمجي داخل مشروعك. وبها يثبّت المساعد الـ SDK، وينشئ مفتاحك ويربطه بتطبيقك، ثم يُجري فحص الإعداد. ما تفعله التعليمات.
- شغّل التطبيق مرة واحدة. عند أول تشغيل يسجّل التطبيق نفسه ويظهر في صفحتك الرئيسية.
الطريقة اليدوية
اختر منصّتك. لكل منصّة صفحة فيها سطر التثبيت لأحدث إصدار من الـ SDK، ومكان المفتاح، والاستدعاءات الأربعة من الميكروفون إلى مخرجات النموذج.
| المنصّة | الحزمة | البدء السريع |
|---|---|---|
| Android | Kotlin، Maven Central | Android |
| iOS و macOS | Swift Package Manager | Apple |
| المتصفحات و Node | npm، WebAssembly | الويب |
| Windows و Linux | C، تُبنى من المصدر باستخدام CMake | Windows و Linux |
ماذا تقرأ بعد ذلك
- المفاهيم: التطبيق، والمفتاح، وإصدار النموذج، وزمن الاستجابة، وما يُنزّله الجهاز.
- ابنِ ملاحظاتك بنفسك: ما هي رؤوس الإخراج (heads)، والعتبات التي تأتي في صورة بيانات، وما يبنيه تطبيقك بنفسه.
- المرجع: صوتيات كل آية وأحكام تجويدها، وكيف ترتبط بالوحدات المتوقَّعة من النموذج، والكتاب والصفحة لكل حكم.
- المفاتيح: ما يفعله المفتاح، وأين تحفظه.
- مشاركة التسجيلات: كيف يمكن للمتعلّمين أن يقدّموا تسجيلاتهم إلى Quran Lab، وما لا تراه أنت أبدًا.
- الأخطاء: كل رمز خطأ في حزم الـ SDK، مع طريقة إصلاحه.
- الخصوصية: كل حقل يرسله الـ SDK، وما تصرّح به في استمارات App Store و Google Play.
إصدارات الـ SDK الأقدم
لا يدعم Quran Lab إلا أحدث إصدار من الـ SDK. والتطبيق الذي يعمل بإصدار أقدم لا يحصل على أي نموذج حتى يُحدَّث، ويبقى مفتاحه كما هو. وتُبيّن صفحة تطبيقك متى يلزم التحديث، وتعطيك تعليمات لمساعدك البرمجي ليُجريه.
أبلغ عن مشكلة أو اطلب شيئًا
للإبلاغ عن خلل أو طلب ميزة أو طرح سؤال، افتح بلاغًا (issue) في مستودع الـ SDK العام:
البلاغات علنية، فلا تضع فيها أي مفتاح ولا أي شيء جاء من متعلّم. أما المشكلة الأمنية فيُبلَّغ عنها عبر تبويب Security في المستودع («Report a vulnerability»)، ولا تُطرح أبدًا في بلاغ عام. ويستطيع مساعدك البرمجي أن يفتح البلاغ نيابةً عنك.