تتيح العديد من المتصفحات الآن إمكانية الوصول إلى إدخال الفيديو والصوت من المستخدم. ومع ذلك، استنادًا إلى المتصفّح، قد تكون تجربة ديناميكية ومضمّنة بالكامل، أو قد يتم تفويضها إلى تطبيق آخر على جهاز المستخدم.
البدء ببساطة وبشكل تدريجي
أسهل ما يمكنك فعله هو ببساطة أن تطلب من المستخدم ملفًا مسجلاً مسبقًا. يمكنك إجراء ذلك من خلال إنشاء عنصر إدخال ملف بسيط وإضافة فلتر accept يشير إلى أنّه يمكننا قبول الملفات الصوتية فقط، وسمة capture تشير إلى أنّنا نريد الحصول على الملفات الصوتية مباشرةً من الميكروفون.
<input type="file" accept="audio/*" capture />
تعمل هذه الطريقة على جميع المنصات. على أجهزة الكمبيوتر المكتبي، سيطلب من المستخدم
تحميل ملف من نظام الملفات (مع تجاهل السمة capture). في Safari على نظام التشغيل iOS، سيفتح تطبيق الميكروفون، مما يسمح لك بتسجيل الصوت ثم إرساله مرة أخرى إلى صفحة الويب؛ على نظام Android، سيمنح المستخدم خيار التطبيق الذي سيستخدمه لتسجيل الصوت قبل إرساله مرة أخرى إلى صفحة الويب.
بعد أن ينتهي المستخدم من التسجيل ويعود إلى الموقع الإلكتروني، عليك
الحصول على بيانات الملف بطريقة ما. يمكنك الوصول بسرعة من خلال
إرفاق حدث onchange بعنصر الإدخال ثم قراءة
السمة files لكائن الحدث.
<input type="file" accept="audio/*" capture id="recorder" />
<audio id="player" controls></audio>
<script>
const recorder = document.getElementById('recorder');
const player = document.getElementById('player');
recorder.addEventListener('change', function (e) {
const file = e.target.files[0];
const url = URL.createObjectURL(file);
// Do something with the audio file.
player.src = url;
});
</script>
</audio>
بعد الوصول إلى الملف، يمكنك إجراء أي تعديلات عليه. على سبيل المثال، يمكنك:
- أرفِقها مباشرةً بعنصر
<audio>لتتمكّن من تشغيلها - تنزيلها على جهاز المستخدم
- تحميله إلى خادم من خلال إرفاقه بـ
XMLHttpRequest - تمرير الصوت من خلال Web Audio API وتطبيق الفلاتر عليه
على الرغم من أنّ استخدام طريقة عنصر الإدخال للوصول إلى البيانات الصوتية أمر شائع، إلا أنّه الخيار الأقل جاذبية. نريد حقًا الوصول إلى الميكروفون وتقديم تجربة رائعة مباشرةً في الصفحة.
الوصول إلى الميكروفون بشكل تفاعلي
يمكن أن يكون للمتصفحات الحديثة خط مباشر إلى الميكروفون، ما يسمح لنا بإنشاء تجارب مدمجة بالكامل مع صفحة الويب ولن يغادر المستخدم المتصفح أبدًا.
الحصول على إذن الوصول إلى الميكروفون
يمكننا الوصول مباشرةً إلى الميكروفون باستخدام واجهة برمجة تطبيقات في مواصفات WebRTC تُسمى getUserMedia(). سيطلب getUserMedia() من المستخدم
منحه إذن الوصول إلى الميكروفونات والكاميرات المتصلة.
في حال نجاح العملية، ستعرض واجهة برمجة التطبيقات Stream يحتوي على البيانات من الكاميرا أو الميكروفون، ويمكننا بعد ذلك إرفاقه بعنصر <audio> أو إرفاقه ببث WebRTC أو إرفاقه بـ AudioContext Web Audio أو حفظه باستخدام واجهة برمجة التطبيقات MediaRecorder.
للحصول على البيانات من الميكروفون، ما عليك سوى ضبط audio: true في عنصر القيود
الذي يتم تمريره إلى واجهة برمجة التطبيقات getUserMedia().
<audio id="player" controls></audio>
<script>
const player = document.getElementById('player');
const handleSuccess = function (stream) {
if (window.URL) {
player.srcObject = stream;
} else {
player.src = stream;
}
};
navigator.mediaDevices
.getUserMedia({audio: true, video: false})
.then(handleSuccess);
</script>
إذا أردت اختيار ميكروفون معيّن، يمكنك أولاً تعداد الميكروفونات المتاحة.
navigator.mediaDevices.enumerateDevices().then((devices) => {
devices = devices.filter((d) => d.kind === 'audioinput');
});
يمكنك بعد ذلك تمرير deviceId الذي تريد استخدامه عند استدعاء getUserMedia.
navigator.mediaDevices.getUserMedia({
audio: {
deviceId: devices[0].deviceId,
},
});
هذا ليس مفيدًا في حد ذاته. كل ما يمكننا فعله هو أخذ البيانات الصوتية وتشغيلها.
الوصول إلى البيانات الأولية من الميكروفون
للوصول إلى البيانات الأولية من الميكروفون، علينا استخدام البث الذي تم إنشاؤه بواسطة
getUserMedia() ثم استخدام واجهة برمجة التطبيقات Web Audio API لمعالجة البيانات. Web Audio API هي واجهة برمجة تطبيقات بسيطة تأخذ مصادر الإدخال وتربطها بالعُقد التي يمكنها معالجة البيانات الصوتية (ضبط مستوى الصوت وما إلى ذلك) وفي النهاية بمكبّر صوت ليتمكّن المستخدم من سماعها.
إحدى العُقد التي يمكنك ربطها هي AudioWorkletNode. تمنحك هذه العقدة
إمكانية منخفضة المستوى لمعالجة الصوت المخصّص. تتم معالجة الصوت الفعلية في طريقة ردّ الاتصال process() في AudioWorkletProcessor.
يمكنك استدعاء هذه الدالة لإدخال المدخلات والمعلَمات وجلب المخرجات.
اطّلِع على مقدّمة حول Audio Worklet لمزيد من المعلومات.
<script>
const handleSuccess = async function(stream) {
const context = new AudioContext();
const source = context.createMediaStreamSource(stream);
await context.audioWorklet.addModule("processor.js");
const worklet = new AudioWorkletNode(context, "worklet-processor");
source.connect(worklet);
worklet.connect(context.destination);
};
navigator.mediaDevices.getUserMedia({ audio: true, video: false })
.then(handleSuccess);
</script>
// processor.js
class WorkletProcessor extends AudioWorkletProcessor {
process(inputs, outputs, parameters) {
// Do something with the data, e.g. convert it to WAV
console.log(inputs);
return true;
}
}
registerProcessor("worklet-processor", WorkletProcessor);
البيانات التي يتم الاحتفاظ بها في المخازن المؤقتة هي البيانات الأولية من الميكروفون، ولديك عدد من الخيارات لما يمكنك فعله بهذه البيانات:
- تحميله مباشرةً إلى الخادم
- تخزينها على الجهاز
- تحويله إلى تنسيق ملف مخصّص، مثل WAV، ثم حفظه على الخوادم أو على الجهاز
حفظ البيانات من الميكروفون
أسهل طريقة لحفظ البيانات من الميكروفون هي استخدام واجهة برمجة التطبيقات MediaRecorder.
ستأخذ واجهة برمجة التطبيقات MediaRecorder مصدر البيانات الذي تم إنشاؤه بواسطة getUserMedia ثم
تحفظ البيانات الموجودة في مصدر البيانات تدريجيًا في وجهتك
المفضلة.
<a id="download">Download</a>
<button id="stop">Stop</button>
<script>
const downloadLink = document.getElementById('download');
const stopButton = document.getElementById('stop');
const handleSuccess = function(stream) {
const options = {mimeType: 'audio/webm'};
const recordedChunks = [];
const mediaRecorder = new MediaRecorder(stream, options);
mediaRecorder.addEventListener('dataavailable', function(e) {
if (e.data.size > 0) recordedChunks.push(e.data);
});
mediaRecorder.addEventListener('stop', function() {
downloadLink.href = URL.createObjectURL(new Blob(recordedChunks));
downloadLink.download = 'acetest.wav';
});
stopButton.addEventListener('click', function() {
mediaRecorder.stop();
});
mediaRecorder.start();
};
navigator.mediaDevices.getUserMedia({ audio: true, video: false })
.then(handleSuccess);
</script>
في حالتنا، نحن نحفظ البيانات مباشرةً في مصفوفة يمكننا تحويلها لاحقًا إلى Blob، والتي يمكن استخدامها بعد ذلك لحفظ البيانات في خادم الويب أو مباشرةً في مساحة التخزين على جهاز المستخدم.
طلب الإذن باستخدام الميكروفون بشكل مسؤول
إذا لم يسبق للمستخدم منح موقعك الإلكتروني إذن الوصول إلى الميكروفون، سيطلب المتصفّح من المستخدم منح موقعك الإلكتروني إذن الوصول إلى الميكروفون فور استدعاء getUserMedia.
لا يحب المستخدمون تلقّي طلبات للوصول إلى الأجهزة الفعّالة على أجهزتهم، وغالبًا ما يحظرون الطلب أو يتجاهلونه إذا لم يفهموا سياق إنشاء الطلب. من أفضل الممارسات طلب الوصول إلى الميكروفون فقط عند الحاجة إليه لأول مرة. بعد أن يمنح المستخدم الإذن، لن يُطلب منه ذلك مرة أخرى، ولكن إذا رفض منح الإذن، لن تتمكّن من طلب الإذن من المستخدم مرة أخرى.
استخدِم واجهة برمجة التطبيقات Permissions API للتحقّق مما إذا كان لديك إذن بالوصول إلى الميزة
لا تتيح لك واجهة برمجة التطبيقات getUserMedia معرفة ما إذا كان لديك إذن بالوصول إلى الميكروفون. يؤدي ذلك إلى حدوث مشكلة، لتوفير واجهة مستخدم جيدة
لجعل المستخدم يمنحك حق الوصول إلى الميكروفون، عليك أن تطلب
الوصول إلى الميكروفون.
ويمكن حلّ هذه المشكلة في بعض المتصفّحات باستخدام Permission API. تتيح لك واجهة برمجة التطبيقات navigator.permission الاستعلام عن حالة إمكانية الوصول إلى واجهات برمجة تطبيقات معيّنة بدون الحاجة إلى طلب الإذن مرة أخرى.
للاستعلام عمّا إذا كان لديك إذن بالوصول إلى ميكروفون المستخدم، يمكنك تمرير
{name: 'microphone'} إلى طريقة الاستعلام، وسيتم عرض إحدى القيم التالية:
-
granted: سبق أن منحك المستخدم إذن الوصول إلى الميكروفون. -
prompt: لم يمنحك المستخدم الإذن بالوصول وسيُطلب منه ذلك عند طلبgetUserMedia -
denied: حظر النظام أو المستخدم صراحةً إمكانية الوصول إلى الميكروفون، ولن تتمكّن من الوصول إليه.
ويمكنك الآن التحقق بسرعة لمعرفة ما إذا كنت بحاجة إلى تغيير واجهة المستخدم الخاصة بك لاستيعاب الإجراءات التي يحتاج المستخدم إلى اتخاذها.
navigator.permissions.query({name: 'microphone'}).then(function (result) {
if (result.state == 'granted') {
} else if (result.state == 'prompt') {
} else if (result.state == 'denied') {
}
result.onchange = function () {};
});