Files
SnapOtter/apps/docs/ar/tools/audio/volume-adjust.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

1.8 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
رفع أو خفض مستوى الصوت بمقدار كسب ثابت بالديسيبل. b9bc1de2c9ef human d9fa73e130aa

ضبط مستوى الصوت

ارفع أو اخفض مستوى صوت ملف صوتي بتطبيق كسب ثابت بالديسيبل.

نقطة نهاية API

POST /api/v1/tools/audio/volume-adjust

يقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صوتي وحقل JSON بصيغة settings.

المعاملات

المعامل النوع مطلوب الافتراضي الوصف
gainDb number لا 3 ضبط مستوى الصوت بالديسيبل (من -30 إلى 30)

مثال على الطلب

curl -X POST http://localhost:1349/api/v1/tools/audio/volume-adjust \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@audio.mp3" \
  -F 'settings={"gainDb": 6}'

مثال على الاستجابة

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
  "originalSize": 4500000,
  "processedSize": 4500000
}

ملاحظات

  • ترفع القيم الموجبة مستوى الصوت؛ وتخفضه القيم السالبة.
  • قد تسبّب قيم الكسب الموجبة الكبيرة قصًّا في الإشارة. استخدم normalize-audio للحصول على تسوية آمنة للجهارة.
  • يحتفظ الخرج عادةً بحاوية الدخل نفسها. يُكتب دخل AAC بصيغة M4A، وتعود المدخلات القابلة للفك فقط وغير المدعومة إلى MP3.