تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
أفضل الممارسات المتعلقة بالمحتوى الصوتي
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تضم هذه الصفحة اقتراحات حول كيفية توفير بيانات الكلام إلى Google Assistant API. تم تصميم هذه الإرشادات لتحقيق مزيد من الكفاءة والدقة،
بالإضافة إلى أوقات استجابة معقولة من الخدمة.
معالجة الصوت مسبقًا
من الأفضل توفير صوت واضح قدر الإمكان باستخدام ميكروفون ذي جودة جيدة ومكان جيد. ومع ذلك، فإنّ تطبيق معالجة إشارة خفض الضوضاء على الصوت قبل إرساله إلى الخدمة عادةً ما يؤدي إلى تقليل دقة التعرّف. تم تصميم الخدمة لمعالجة الصوت الصاخب.
للحصول على أفضل النتائج:
- ضَع الميكروفون بالقرب من المستخدم قدر الإمكان، لا سيما عند وجود ضوضاء في الخلفية.
- تجنَّب قطع الصوت.
- عدم استخدام ميزة التحكّم التلقائي في الكسب (AGC)
- يجب إيقاف جميع عمليات معالجة تقليل الضوضاء.
من الناحية المثالية:
- ينبغي معايرة مستوى الصوت بحيث لا يتم اقتطاع إشارة الإدخال،
وتصل مستويات الصوت في ذروة الكلام إلى حوالي -20 إلى -10 ديسيبل إف بي.
- من المفترض أن يعرض الجهاز تقريبًا سعات "مسطّحة" مقارنةً بخصائص التردّد الصوتي (+- 3 ديسيبل من 100 هرتز إلى 8000 هرتز).
- يجب أن يكون إجمالي التشوّه التوافقي أقل من% 1 من 100 هرتز إلى 8000 هرتز عند مستوى إدخال SPL يبلغ 90 ديسيبل.
معدّل البيانات في الملف الصوتي
إذا أمكن، اضبط معدّل أخذ العيّنة لمصدر الصوت على 16000 هرتز، وإلا يمكنك
ضبط sample_rate_hertz بحيث يتطابق مع معدّل العيّنة الأصلي لمصدر الصوت (بدلاً من
إعادة أخذ العيّنات).
حجم الإطار
يتعرّف "مساعد Google" على الصوت المباشر عند تسجيله من ميكروفون.
يجب تقسيم البث الصوتي إلى إطارات وإرساله في رسائل AssistRequest متتالية. يُسمح باستخدام أي حجم إطار. الإطارات الأكبر أكثر كفاءة
لكنها تضيف وقت استجابة. وننصحك باستخدام حجم إطار يبلغ 100 مللي ثانية كوسيلة
مفاضلة جيدة بين وقت الاستجابة والكفاءة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page provides recommendations for submitting speech data to the Google Assistant API for optimal performance.\u003c/p\u003e\n"],["\u003cp\u003eFor best results, use a high-quality microphone, position it close to the user, avoid audio clipping and noise reduction processing, and disable automatic gain control.\u003c/p\u003e\n"],["\u003cp\u003eIdeally, calibrate audio levels to prevent clipping, maintain a flat frequency response, and minimize harmonic distortion.\u003c/p\u003e\n"],["\u003cp\u003eSet the audio source sampling rate to 16000 Hz if possible, or match the native rate, and use a frame size of around 100 milliseconds for a balance between latency and efficiency.\u003c/p\u003e\n"]]],[],null,["# Best Practices for Audio\n\nThis page contains recommendations on how to provide speech data to the\nGoogle Assistant API. These guidelines are designed for greater efficiency\nand accuracy as well as reasonable response times from the service.\n\nAudio pre-processing\n--------------------\n\nIt's best to provide audio that is as clean as possible by using a good quality\nand well-positioned microphone. However, applying noise-reduction signal\nprocessing to the audio before sending it to the service typically reduces\nrecognition accuracy. The service is designed to handle noisy audio.\n\nFor best results:\n\n- Position the microphone as close to the user as possible, particularly when background noise is present.\n- Avoid audio clipping.\n- Do not use automatic gain control (AGC).\n- All noise reduction processing should be disabled.\n\nIdeally:\n\n- The audio level should be calibrated so that the input signal does not clip, and peak speech audio levels reach approximately -20 to -10 dBFS.\n- The device should exhibit approximately \"flat\" amplitude versus frequency characteristics (+- 3 dB 100 Hz to 8000 Hz).\n- Total harmonic distortion should be less than 1% from 100 Hz to 8000 Hz at 90 dB SPL input level.\n\nSampling rate\n-------------\n\nIf possible, set the sampling rate of the audio source to 16000 Hz. Otherwise,\nset the [`sample_rate_hertz`](/assistant/sdk/reference/rpc/google.assistant.embedded.v1alpha2#google.assistant.embedded.v1alpha2.AudioInConfig) to match the native sample rate of the audio source (instead\nof re-sampling).\n\nFrame size\n----------\n\nThe Google Assistant recognizes live audio as it is captured from a microphone.\nThe audio stream must be split into frames and sent in consecutive\n`AssistRequest` messages. Any frame size is acceptable. Larger frames are more\nefficient, but add latency. A 100-millisecond frame size is recommended as a\ngood tradeoff between latency and efficiency."]]
