TutuAudio · مكوّن قابل للتضمين

سطر واحد من الكود — أضف محرر صوت إلى موقعك في ثوانٍ

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

جرّبه مباشرة عرض الكود إنشاء مفتاح

انسخ والصق — قبل وسم </body> الخاص بصفحتك

<script src="https://tutuaudio.com/embed.js"
        data-key="pk_live_YOUR_KEY"
        data-mount="#aa-editor" defer></script>

استبدل pk_live_YOUR_KEY بمفتاح تم إنشاؤه في لوحة التحكم؛ يجب أن يكون للحاوية #aa-editor عرض وارتفاع. يمكنك ضبط قائمة نطاقات مسموح بها/محظورة لكي يظهر على موقعك فقط.

جرّبه مباشرة

انقر الزر أدناه لتجربة محرر صوت المضمّن هنا مباشرة.

‏JS API (لاستدعاءات الرجوع / التخصيص)

<script src="https://tutuaudio.com/embed.js"></script>
<script>
  const aa = TutuAudio.mount('#aa-editor', {
    key: 'pk_live_YOUR_KEY',
    theme: 'auto',            // auto | light | dark
    onSave: (file) => {
      // file.dataUrl = the finished mix (WAV, base64)
      upload(file.dataUrl);
    }
  });
  aa.open('https://your.site/sound.mp3'); // import an audio clip
</script>

خيارات الإعداد الكاملة

المُعامل	النوع	الوصف
key	string	مفتاحك العام pk_ (يُنشأ في لوحة التحكم). مطلوب.
theme	'auto'\|'light'\|'dark'	السمة؛ auto يتبع الوضع الفاتح/الداكن للمضيف/النظام.
saveText	string	نص زر «تم» (الافتراضي «إنهاء وإرجاع»، ≤16 حرفًا). يظهر هذا الزر في الشريط العلوي الأصلي للمحرر عند ضبط onSave.
hideSuite	boolean	إخفاء مُشغّل حزمة التطبيقات (مخفي افتراضيًا عند التضمين لتقليل التشتيت).
hideAccount	boolean	إخفاء عناصر تسجيل الدخول/الحساب (مخفية افتراضيًا عند التضمين؛ المضيف يدير تسجيل الدخول).
hideExport	boolean	إخفاء زر التصدير/التنزيل المدمج في المحرر (عند استخدام «إنهاء وإرجاع» فقط).
hideLang	boolean	إخفاء مبدّل اللغة (يتحكم فيه المضيف عبر tt_locale).
hideTheme	boolean	إخفاء مبدّل الوضع الفاتح/الداكن (يتحكم فيه المضيف عبر tt_theme).

الطرق

aa.open(url, name?)استيراد مقطع صوتي إلى مسار (url أو dataURL لصوت/فيديو/صورة).
aa.export()عرض المزيج دون اتصال وتصدير WAV ← Promise<{dataUrl,mime,size}>.
aa.setTheme('dark')تبديل السمة أثناء التشغيل.
aa.destroy()إلغاء تحميل المكوّن (إزالة الـ iframe).

استدعاءات الأحداث

onReady()المحرر جاهز.
onSave(file)ينقر المستخدم «تم» ← file.dataUrl هو المزيج النهائي (WAV).
onError(e)‏e.message مصاغة بلغة مفهومة (غير مُفعّل / لا صلاحية / فشل التحميل).
onClose()تم إغلاق الطبقة الملء للشاشة.

الأمان · التحديثات التلقائية

· المفتاح عام؛ قائمة مواقع التضمين المسموح بها/المحظورة تمنع إساءة الاستخدام (تكون الغلبة للقائمة المحظورة)؛ يمكنك الإيقاف أو الاستئناف في أي وقت.
· يعمل المحرر على نطاق TutuAudio الخاص (معزول)؛ لا يمكن لصفحتك الوصول إلى أي بيانات اعتماد لـ TutuAudio.
· المكوّن مستضاف ذاتيًا ويُحدَّث تلقائيًا من قِبل TutuAudio —— لا تتطلب ترقيات الميزات أي تغييرات في الكود من جانبك؛ بلا صيانة.