1. مقدمة
WebRTC هو مشروع برنامج مفتوح المصدر يتيح الاتصال في الوقت الفعلي بالصوت والفيديو والبيانات في تطبيقات الويب والتطبيقات الأصلية.
تتضمّن WebRTC العديد من واجهات برمجة التطبيقات المستندة إلى JavaScript. انقر على الروابط للاطّلاع على عروض توضيحية.
getUserMedia(): لتسجيل الصوت والفيديوMediaRecorder: لتسجيل الصوت والفيديو-
RTCPeerConnection: لبث الصوت والفيديو بين المستخدمين RTCDataChannel: بث البيانات بين المستخدمين
أين يمكنني استخدام WebRTC؟
في Firefox وOpera وChrome على أجهزة الكمبيوتر المكتبي وAndroid تتوفّر WebRTC أيضًا للتطبيقات الأصلية على أجهزة iOS وAndroid.
ما هي الإشارات؟
تستخدم WebRTC واجهة RTCPeerConnection لنقل بيانات البث بين المتصفّحات، ولكنّها تحتاج أيضًا إلى آلية لتنسيق الاتصال وإرسال رسائل التحكّم، وهي عملية تُعرف باسم الإشارات. لا يحدّد WebRTC طرق الإشارات وبروتوكولاتها. في هذا الدرس التطبيقي حول الترميز، ستستخدم Socket.IO للمراسلة، ولكن هناك العديد من البدائل.
ما هما STUN وTURN؟
تم تصميم WebRTC للعمل من نظير إلى نظير، بحيث يمكن للمستخدمين الاتصال من خلال المسار الأكثر مباشرةً. ومع ذلك، تم تصميم WebRTC للتعامل مع الشبكات الواقعية: تحتاج تطبيقات العميل إلى اجتياز بوابات NAT وجدران الحماية، وتحتاج شبكات الاتصال من نظير إلى نظير إلى إجراءات احتياطية في حال تعذّر الاتصال المباشر. في إطار هذه العملية، تستخدم واجهات برمجة تطبيقات WebRTC خوادم STUN للحصول على عنوان IP لجهاز الكمبيوتر، وخوادم TURN لتعمل كخوادم ترحيل في حال تعذُّر الاتصال من نظير إلى نظير. (يشرح WebRTC في العالم الحقيقي بمزيد من التفصيل).
هل WebRTC آمن؟
التشفير إلزامي لجميع مكوّنات WebRTC، ولا يمكن استخدام واجهات برمجة التطبيقات JavaScript إلا من مصادر آمنة (HTTPS أو المضيف المحلي). لا تحدّد معايير WebRTC آليات الإشارة، لذا عليك التأكّد من استخدام بروتوكولات آمنة.
2. نظرة عامة
يمكنك إنشاء تطبيق للحصول على فيديو والتقاط لقطات باستخدام كاميرا الويب ومشاركتها مع الآخرين باستخدام WebRTC. ستتعرّف أيضًا على كيفية استخدام واجهات برمجة تطبيقات WebRTC الأساسية وإعداد خادم مراسلة باستخدام Node.js.
أهداف الدورة التعليمية
- الحصول على فيديو من كاميرا الويب
- بث الفيديو باستخدام RTCPeerConnection
- بث البيانات باستخدام RTCDataChannel
- إعداد خدمة إرسال إشارات لتبادل الرسائل
- الجمع بين اتصال النظير والإشارات
- التقاط صورة ومشاركتها باستخدام قناة بيانات
المتطلبات
- الإصدار 47 من Chrome أو الإصدارات الأحدث
- خادم الويب لمتصفّح Chrome، أو استخدام خادم الويب الذي تختاره.
- الرمز النموذجي
- محرِّر نصوص
- معرفة أساسية بلغات HTML وCSS وJavaScript
3- الحصول على الرمز النموذجي
تنزيل الرمز
إذا كنت على دراية بـ git، يمكنك تنزيل الرمز البرمجي لهذا الدرس التطبيقي حول الترميز من GitHub عن طريق استنساخه:
git clone https://github.com/googlecodelabs/webrtc-web
بدلاً من ذلك، انقر على الزر التالي لتنزيل ملف .zip للرمز:
افتح ملف ZIP الذي تم تنزيله. سيؤدي ذلك إلى فك حزمة مجلد المشروع (adaptive-web-media) الذي يحتوي على مجلد واحد لكل خطوة من خطوات هذا الدرس التطبيقي حول الترميز، بالإضافة إلى جميع الموارد التي ستحتاج إليها.
ستنفّذ جميع أعمال الترميز في الدليل الذي يحمل الاسم work.
تحتوي مجلدات step-nn على نسخة منتهية لكل خطوة من خطوات هذا الدرس التطبيقي حول الترميز. وهي موجودة كمرجع.
تثبيت خادم الويب والتحقّق منه
على الرغم من أنّه يمكنك استخدام خادم الويب الخاص بك، تم تصميم هذا الدرس التطبيقي حول الترميز ليعمل بشكل جيد مع خادم الويب Chrome. إذا لم يكن هذا التطبيق مثبّتًا لديك، يمكنك تثبيته من "سوق Chrome الإلكتروني".

بعد تثبيت تطبيق Web Server for Chrome، انقر على اختصار "تطبيقات Chrome" من شريط الإشارات المرجعية أو صفحة "علامة تبويب جديدة" أو من "مشغّل التطبيقات":

انقر على رمز خادم الويب:

بعد ذلك، سيظهر لك مربّع الحوار هذا الذي يتيح لك ضبط خادم الويب المحلي:

انقر على الزر اختيار مجلد (CHOOSE FOLDER)، واختَر المجلد work الذي أنشأته للتو. سيتيح لك ذلك عرض عملك قيد التقدّم في Chrome باستخدام عنوان URL المميّز في مربّع حوار خادم الويب في قسم عناوين URL لخادم الويب.
ضِمن الخيارات، ضَع علامة في المربّع بجانب عرض index.html تلقائيًا كما هو موضّح هنا:

بعد ذلك، أوقِف الخادم وأعِد تشغيله من خلال تحريك مفتاح التبديل الذي يحمل التصنيف خادم الويب: تم البدء إلى اليمين ثم إلى اليسار.

انتقِل الآن إلى موقع العمل في متصفّح الويب من خلال النقر على عنوان URL الخاص بخادم الويب المميّز. من المفترض أن تظهر لك صفحة تشبه هذه الصفحة، والتي تتوافق مع work/index.html:

من الواضح أنّ هذا التطبيق لا يؤدي أي وظيفة مثيرة للاهتمام حتى الآن، فهو مجرد هيكل بسيط نستخدمه للتأكّد من أنّ خادم الويب يعمل بشكل صحيح. ستضيف ميزات الوظائف والتخطيط في الخطوات اللاحقة.
4. بث فيديو من كاميرا الويب
أهداف الدورة التعليمية
في هذه الخطوة، ستتعرّف على كيفية:
- احصل على بث فيديو من كاميرا الويب.
- التحكّم في تشغيل البث
- استخدِم CSS وSVG لمعالجة الفيديو.
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-01.
القليل من HTML...
أضِف عنصر video وعنصر script إلى index.html في دليل work:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<video autoplay playsinline></video>
<script src="js/main.js"></script>
</body>
</html>
...وقليل من JavaScript
أضِف ما يلي إلى main.js في مجلد js:
'use strict';
// On this codelab, you will be streaming only video (video: true).
const mediaStreamConstraints = {
video: true,
};
// Video element where stream will be placed.
const localVideo = document.querySelector('video');
// Local stream that will be reproduced on the video.
let localStream;
// Handles success by adding the MediaStream to the video element.
function gotLocalMediaStream(mediaStream) {
localStream = mediaStream;
localVideo.srcObject = mediaStream;
}
// Handles error by logging a message to the console with the error message.
function handleLocalMediaStreamError(error) {
console.log('navigator.getUserMedia error: ', error);
}
// Initializes media stream.
navigator.mediaDevices.getUserMedia(mediaStreamConstraints)
.then(gotLocalMediaStream).catch(handleLocalMediaStreamError);
للتجربة:
افتح index.html في المتصفّح، ومن المفترض أن يظهر لك شيء مشابه لما يلي (مع عرض ما تلتقطه كاميرا الويب بالطبع):

آلية العمل
بعد استدعاء getUserMedia()، يطلب المتصفّح من المستخدم الإذن بالوصول إلى الكاميرا (إذا كانت هذه هي المرة الأولى التي يتم فيها طلب الوصول إلى الكاميرا من المصدر الحالي). في حال نجاح العملية، يتم عرض MediaStream، والذي يمكن استخدامه بواسطة عنصر وسائط باستخدام السمة srcObject:
navigator.mediaDevices.getUserMedia(mediaStreamConstraints)
.then(gotLocalMediaStream).catch(handleLocalMediaStreamError);
}
function gotLocalMediaStream(mediaStream) {
localVideo.srcObject = mediaStream;
}
تتيح لك الوسيطة constraints تحديد الوسائط التي تريد الحصول عليها. في هذا المثال، يتم تشغيل الفيديو فقط، لأنّ الصوت يكون غير مفعّل تلقائيًا:
const mediaStreamConstraints = {
video: true,
};
يمكنك استخدام القيود لمتطلبات إضافية مثل دقة الفيديو:
const hdConstraints = {
video: {
width: {
min: 1280
},
height: {
min: 720
}
}
}
تسرد مواصفات MediaTrackConstraints جميع أنواع القيود المحتملة، على الرغم من أنّ بعض الخيارات غير متوافقة مع بعض المتصفّحات. إذا كانت الدقة المطلوبة غير متوافقة مع الكاميرا المحدّدة، سيتم رفض getUserMedia() مع ظهور OverconstrainedError ولن يُطلب من المستخدم منح الإذن بالوصول إلى الكاميرا.
إذا نجح getUserMedia()، يتم ضبط بث الفيديو من كاميرا الويب كمصدر لعنصر الفيديو:
function gotLocalMediaStream(mediaStream) {
localVideo.srcObject = mediaStream;
}
نقاط المكافأة
- إنّ عنصر
localStreamالذي تم تمريره إلىgetUserMedia()يقع في النطاق العام، لذا يمكنك فحصه من وحدة تحكّم المتصفّح: افتح وحدة التحكّم واكتب stream ثم اضغط على مفتاح Return. (لعرض وحدة التحكّم في Chrome، اضغط على Ctrl-Shift-J أو Command-Option-J إذا كنت تستخدم جهاز Mac). - ماذا تعرض الدالة
localStream.getVideoTracks()؟ - يُرجى محاولة الاتصال بـ
localStream.getVideoTracks()[0].stop(). - انظر إلى عنصر القيود: ماذا يحدث عند تغييره إلى
{audio: true, video: true}؟ - ما هو حجم عنصر الفيديو؟ كيف يمكنك الحصول على الحجم الطبيعي للفيديو من JavaScript، بدلاً من حجم العرض؟ استخدِم "أدوات مطوّري البرامج في Chrome" للتحقّق من ذلك.
- جرِّب إضافة فلاتر CSS إلى عنصر الفيديو. على سبيل المثال:
video {
filter: blur(4px) invert(1) opacity(0.5);
}
- جرِّب إضافة فلاتر SVG. على سبيل المثال:
video {
filter: hue-rotate(180deg) saturate(200%);
}
ما تعلّمته
في هذه الخطوة، تعرّفت على كيفية:
- الحصول على فيديو من كاميرا الويب
- اضبط قيود الوسائط.
- التلاعب بعنصر الفيديو
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-01.
نصائح
- لا تنسَ سمة
autoplayفي العنصرvideo. بدون ذلك، ستظهر لك لقطة واحدة فقط. - هناك العديد من الخيارات الأخرى لقيود
getUserMedia(). يمكنك الاطّلاع على العرض التوضيحي على webrtc.github.io/samples/src/content/peerconnection/constraints. كما سترى، هناك الكثير من نماذج WebRTC المثيرة للاهتمام على هذا الموقع.
أفضل ممارسة
- تأكَّد من أنّ عنصر الفيديو لا يتجاوز حجم الحاوية. لقد أضفنا
widthوmax-widthلضبط الحجم المفضّل والحجم الأقصى للفيديو. سيحتسب المتصفّح الارتفاع تلقائيًا:
video {
max-width: 100%;
width: 320px;
}
التالي
لديك فيديو، ولكن كيف يمكنك بثّه؟ يمكنك معرفة ذلك في الخطوة التالية.
5- بث الفيديو باستخدام RTCPeerConnection
أهداف الدورة التعليمية
في هذه الخطوة، ستتعرّف على كيفية:
- يمكنك إخفاء الاختلافات بين المتصفّحات باستخدام واجهة WebRTC، وهي adapter.js.
- استخدِم واجهة برمجة التطبيقات RTCPeerConnection لبث الفيديو.
- التحكّم في التقاط الوسائط وبثّها
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-2.
ما هو RTCPeerConnection؟
RTCPeerConnection هي واجهة برمجة تطبيقات لإجراء مكالمات WebRTC لبث الفيديو والصوت وتبادل البيانات.
يُنشئ هذا المثال اتصالاً بين عنصرَي RTCPeerConnection (يُعرفان باسم "الأقران") على الصفحة نفسها.
لا فائدة عملية كبيرة، ولكنها جيدة لفهم كيفية عمل RTCPeerConnection.
إضافة عناصر الفيديو وأزرار التحكّم
في index.html، استبدِل عنصر الفيديو الفردي بعنصرَي فيديو وثلاثة أزرار:
<video id="localVideo" autoplay playsinline></video>
<video id="remoteVideo" autoplay playsinline></video>
<div>
<button id="startButton">Start</button>
<button id="callButton">Call</button>
<button id="hangupButton">Hang Up</button>
</div>
سيعرض أحد عناصر الفيديو البث من getUserMedia()، بينما سيعرض الآخر الفيديو نفسه الذي يتم بثه باستخدام RTCPeerconnection. (في تطبيق حقيقي، سيعرض عنصر فيديو واحد البث المحلي والآخر البث عن بُعد).
إضافة ملف adapter.js shim
أضِف رابطًا إلى الإصدار الحالي من adapter.js فوق الرابط إلى main.js:
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
يُفترض أن يظهر ملف Index.html الآن على النحو التالي:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<video id="localVideo" autoplay playsinline></video>
<video id="remoteVideo" autoplay playsinline></video>
<div>
<button id="startButton">Start</button>
<button id="callButton">Call</button>
<button id="hangupButton">Hang Up</button>
</div>
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="js/main.js"></script>
</body>
</html>
تثبيت رمز RTCPeerConnection
استبدِل main.js بالنسخة في المجلد step-02.
إجراء المكالمة
افتح index.html، وانقر على الزر بدء للحصول على فيديو من كاميرا الويب، ثم انقر على اتصال لإجراء اتصال بين النظراء. من المفترض أن يظهر الفيديو نفسه (من كاميرا الويب) في كلا عنصرَي الفيديو. اطّلِع على وحدة تحكّم المتصفّح لعرض سجلّات WebRTC.
آلية العمل
هذه الخطوة تتضمّن الكثير من التفاصيل...
تستخدم WebRTC واجهة برمجة التطبيقات RTCPeerConnection لإعداد اتصال لبث الفيديو بين عملاء WebRTC، والمعروفين باسم الأقران.
في هذا المثال، يظهر كائنا RTCPeerConnection على الصفحة نفسها: pc1 وpc2. لا فائدة عملية كبيرة، ولكنها جيدة لتوضيح كيفية عمل واجهات برمجة التطبيقات.
يتضمن إعداد مكالمة بين أطراف WebRTC ثلاث مهام:
- أنشئ RTCPeerConnection لكل طرف من طرفَي المكالمة، وأضِف البث المحلي من
getUserMedia()في كل طرف. - الحصول على معلومات الشبكة ومشاركتها: تُعرف نقاط النهاية المحتملة للاتصال باسم مرشحي ICE.
- الحصول على الأوصاف المحلية والبعيدة ومشاركتها: البيانات الوصفية حول الوسائط المحلية بتنسيق SDP
لنفترض أنّ "سارة" و"سامي" يريدان استخدام RTCPeerConnection لإعداد محادثة فيديو.
في البداية، يتبادل "ياسر" و"هبة" معلومات الشبكة. يشير التعبير "العثور على المرشحين" إلى عملية العثور على واجهات الشبكة والمنافذ باستخدام إطار عمل ICE.
- تنشئ "أمل" عنصر RTCPeerConnection باستخدام معالج
onicecandidate (addEventListener('icecandidate')). يتوافق هذا مع الرمز التالي من main.js:
let localPeerConnection;
localPeerConnection = new RTCPeerConnection(servers);
localPeerConnection.addEventListener('icecandidate', handleConnection);
localPeerConnection.addEventListener(
'iceconnectionstatechange', handleConnectionChange);
- تتصل "أليس" بـ
getUserMedia()وتضيف البث الذي تم تمريره إلى ذلك:
navigator.mediaDevices.getUserMedia(mediaStreamConstraints).
then(gotLocalMediaStream).
catch(handleLocalMediaStreamError);
function gotLocalMediaStream(mediaStream) {
localVideo.srcObject = mediaStream;
localStream = mediaStream;
trace('Received local stream.');
callButton.disabled = false; // Enable call button.
}
localPeerConnection.addStream(localStream);
trace('Added local stream to localPeerConnection.');
- يتم استدعاء معالج
onicecandidateمن الخطوة 1 عندما تصبح الشبكات المرشحة متاحة. - ترسل "أمل" بيانات المرشّحين المتسلسلة إلى "باسم". في التطبيق الحقيقي، تتم هذه العملية (المعروفة باسم الإشارة) باستخدام خدمة مراسلة، وستتعرّف على كيفية إجراء ذلك في خطوة لاحقة. بالطبع، في هذه الخطوة، يكون كائنا RTCPeerConnection على الصفحة نفسها ويمكنهما التواصل مباشرةً بدون الحاجة إلى مراسلة خارجية.
- عندما يتلقّى "باسم" رسالة مرشّح من "أمل"، يتصل بالدالة
addIceCandidate()لإضافة المرشّح إلى وصف النظير البعيد:
function handleConnection(event) {
const peerConnection = event.target;
const iceCandidate = event.candidate;
if (iceCandidate) {
const newIceCandidate = new RTCIceCandidate(iceCandidate);
const otherPeer = getOtherPeer(peerConnection);
otherPeer.addIceCandidate(newIceCandidate)
.then(() => {
handleConnectionSuccess(peerConnection);
}).catch((error) => {
handleConnectionFailure(peerConnection, error);
});
trace(`${getPeerName(peerConnection)} ICE candidate:\n` +
`${event.candidate.candidate}.`);
}
}
تحتاج أطراف WebRTC أيضًا إلى معرفة وتبادل معلومات وسائط الصوت والفيديو المحلية والبعيدة، مثل الدقة وإمكانات برامج الترميز. تتم الإشارة لتبادل معلومات إعدادات الوسائط من خلال تبادل مجموعات من البيانات الوصفية، تُعرف باسم عرض وإجابة، باستخدام تنسيق "بروتوكول وصف الجلسة"، المعروف باسم SDP:
- تُشغّل نبيلة طريقة RTCPeerConnection
createOffer(). يوفّر الوعد الذي تم إرجاعه RTCSessionDescription: وصف جلسة "أليس" المحلية:
trace('localPeerConnection createOffer start.');
localPeerConnection.createOffer(offerOptions)
.then(createdOffer).catch(setSessionDescriptionError);
- في حال نجاح العملية، تضبط "أليس" الوصف المحلي باستخدام
setLocalDescription()ثم ترسل وصف الجلسة هذا إلى "بوب" باستخدام قناة الإشارة. - يضبط "باسم" الوصف الذي أرسلته "أمل" كوصف عن بُعد باستخدام
setRemoteDescription(). - يشغّل "باسم" طريقة RTCPeerConnection
createAnswer()، ويمرّر إليها الوصف البعيد الذي حصل عليه من "أمل"، لإنشاء جلسة محلية متوافقة مع جلستها. يتم تمرير الوعدcreateAnswer()إلى RTCSessionDescription: يضبطه "يوسف" كوصف محلي ويرسله إلى "نبيلة". - عندما تتلقّى "أمل" وصف جلسة "باسم"، تضبطه كوصف عن بُعد باستخدام
setRemoteDescription().
// Logs offer creation and sets peer connection session descriptions.
function createdOffer(description) {
trace(`Offer from localPeerConnection:\n${description.sdp}`);
trace('localPeerConnection setLocalDescription start.');
localPeerConnection.setLocalDescription(description)
.then(() => {
setLocalDescriptionSuccess(localPeerConnection);
}).catch(setSessionDescriptionError);
trace('remotePeerConnection setRemoteDescription start.');
remotePeerConnection.setRemoteDescription(description)
.then(() => {
setRemoteDescriptionSuccess(remotePeerConnection);
}).catch(setSessionDescriptionError);
trace('remotePeerConnection createAnswer start.');
remotePeerConnection.createAnswer()
.then(createdAnswer)
.catch(setSessionDescriptionError);
}
// Logs answer to offer creation and sets peer connection session descriptions.
function createdAnswer(description) {
trace(`Answer from remotePeerConnection:\n${description.sdp}.`);
trace('remotePeerConnection setLocalDescription start.');
remotePeerConnection.setLocalDescription(description)
.then(() => {
setLocalDescriptionSuccess(remotePeerConnection);
}).catch(setSessionDescriptionError);
trace('localPeerConnection setRemoteDescription start.');
localPeerConnection.setRemoteDescription(description)
.then(() => {
setRemoteDescriptionSuccess(localPeerConnection);
}).catch(setSessionDescriptionError);
}
- إشعار
نقاط المكافأة
- ألقِ نظرة على chrome://webrtc-internals. يوفّر هذا الخيار إحصاءات WebRTC وبيانات تصحيح الأخطاء. (يمكنك الاطّلاع على قائمة كاملة بعناوين URL في Chrome على chrome://about).
- صمِّم الصفحة باستخدام CSS:
- ضع الفيديوهات جنبًا إلى جنب.
- اجعل الأزرار بنفس العرض، مع نص أكبر.
- تأكَّد من أنّ التنسيق يعمل على الأجهزة الجوّالة.
- من وحدة تحكّم "أدوات مطوّري البرامج في Chrome"، اطّلِع على
localStreamوlocalPeerConnectionوremotePeerConnection. - من وحدة التحكّم، اطّلِع على
localPeerConnectionpc1.localDescription. كيف يبدو تنسيق SDP؟
ما تعلّمته
في هذه الخطوة، تعرّفت على كيفية:
- يمكنك إخفاء الاختلافات بين المتصفّحات باستخدام واجهة WebRTC، وهي adapter.js.
- استخدِم واجهة برمجة التطبيقات RTCPeerConnection لبث الفيديو.
- التحكّم في التقاط الوسائط وبثّها
- مشاركة معلومات الوسائط والشبكة بين الأقران لتفعيل مكالمة WebRTC
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-2.
نصائح
- هناك الكثير لنتعلّمه في هذه الخطوة. للعثور على مراجع أخرى تشرح RTCPeerConnection بمزيد من التفصيل، يمكنك الاطّلاع على webrtc.org. تتضمّن هذه الصفحة اقتراحات لأُطر عمل JavaScript، إذا كنت تريد استخدام WebRTC، ولكنك لا تريد التعامل مع واجهات برمجة التطبيقات.
- يمكنك الاطّلاع على مزيد من المعلومات عن shim adapter.js من مستودع adapter.js GitHub.
- هل تريد الاطّلاع على أفضل تطبيق لمحادثات الفيديو في العالم؟ يمكنك الاطّلاع على AppRTC، وهو التطبيق الأساسي لمشروع WebRTC لإجراء مكالمات WebRTC: التطبيق، الرمز. يجب أن يكون وقت إعداد المكالمة أقل من 500 ملي ثانية.
أفضل ممارسة
- لضمان توافق الرمز البرمجي مع الإصدارات المستقبلية، استخدِم واجهات برمجة التطبيقات الجديدة المستندة إلى Promise وفعِّل التوافق مع المتصفّحات التي لا تتيح استخدامها من خلال adapter.js.
التالي
توضّح هذه الخطوة كيفية استخدام WebRTC لبث الفيديو بين النظراء، ولكن هذا الدرس التطبيقي حول الترميز يتناول أيضًا البيانات.
في الخطوة التالية، تعرَّف على كيفية بث بيانات عشوائية باستخدام RTCDataChannel.
6. استخدام RTCDataChannel لتبادل البيانات
أهداف الدورة التعليمية
- كيفية تبادل البيانات بين نقاط نهاية WebRTC (الأجهزة النظيرة)
يتوفّر إصدار كامل من هذه الخطوة في المجلد step-03.
تعديل رمز HTML
في هذه الخطوة، ستستخدم قنوات بيانات WebRTC لإرسال نص بين عنصرَي textarea على الصفحة نفسها. هذا ليس مفيدًا للغاية، ولكنه يوضّح كيف يمكن استخدام WebRTC لمشاركة البيانات بالإضافة إلى بث الفيديو.
أزِل عنصرَي الفيديو والزر من index.html واستبدِلهما برمز HTML التالي:
<textarea id="dataChannelSend" disabled
placeholder="Press Start, enter some text, then press Send."></textarea>
<textarea id="dataChannelReceive" disabled></textarea>
<div id="buttons">
<button id="startButton">Start</button>
<button id="sendButton">Send</button>
<button id="closeButton">Stop</button>
</div>
ستكون إحدى مساحات النص مخصّصة لإدخال النص، بينما ستعرض الأخرى النص أثناء بثه بين الأقران.
يُفترض أن يظهر ملف index.html الآن على النحو التالي:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<textarea id="dataChannelSend" disabled
placeholder="Press Start, enter some text, then press Send."></textarea>
<textarea id="dataChannelReceive" disabled></textarea>
<div id="buttons">
<button id="startButton">Start</button>
<button id="sendButton">Send</button>
<button id="closeButton">Stop</button>
</div>
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="js/main.js"></script>
</body>
</html>
تعديل رمز JavaScript
استبدِل main.js بمحتوى step-03/js/main.js.
جرِّب بث البيانات بين النظراء: افتح index.html، واضغط على Start (بدء) لإعداد اتصال النظير، وأدخِل بعض النصوص في textarea على اليمين، ثم انقر على Send (إرسال) لنقل النص باستخدام قنوات بيانات WebRTC.
آلية العمل
يستخدم هذا الرمز RTCPeerConnection وRTCDataChannel لتفعيل تبادل الرسائل النصية.
يتشابه الكثير من الرموز في هذه الخطوة مع مثال RTCPeerConnection.
تحتوي الدالتان sendData() وcreateConnection() على معظم الرموز الجديدة:
function createConnection() {
dataChannelSend.placeholder = '';
var servers = null;
pcConstraint = null;
dataConstraint = null;
trace('Using SCTP based data channels');
// For SCTP, reliable and ordered delivery is true by default.
// Add localConnection to global scope to make it visible
// from the browser console.
window.localConnection = localConnection =
new RTCPeerConnection(servers, pcConstraint);
trace('Created local peer connection object localConnection');
sendChannel = localConnection.createDataChannel('sendDataChannel',
dataConstraint);
trace('Created send data channel');
localConnection.onicecandidate = iceCallback1;
sendChannel.onopen = onSendChannelStateChange;
sendChannel.onclose = onSendChannelStateChange;
// Add remoteConnection to global scope to make it visible
// from the browser console.
window.remoteConnection = remoteConnection =
new RTCPeerConnection(servers, pcConstraint);
trace('Created remote peer connection object remoteConnection');
remoteConnection.onicecandidate = iceCallback2;
remoteConnection.ondatachannel = receiveChannelCallback;
localConnection.createOffer().then(
gotDescription1,
onCreateSessionDescriptionError
);
startButton.disabled = true;
closeButton.disabled = false;
}
function sendData() {
var data = dataChannelSend.value;
sendChannel.send(data);
trace('Sent Data: ' + data);
}
تشبه بنية RTCDataChannel عن قصد WebSocket، مع طريقة send() وحدث message.
لاحظ استخدام dataConstraint. يمكن ضبط قنوات البيانات لتفعيل أنواع مختلفة من مشاركة البيانات، مثل إعطاء الأولوية للتسليم الموثوق على الأداء. يمكنك الاطّلاع على مزيد من المعلومات حول الخيارات في شبكة مطوّري Mozilla.
نقاط المكافأة
- باستخدام SCTP، وهو البروتوكول الذي تستخدمه قنوات بيانات WebRTC، يتم تفعيل تسليم البيانات الموثوقة والمرتبة تلقائيًا. متى قد تحتاج RTCDataChannel إلى توفير تسليم موثوق للبيانات، ومتى قد يكون الأداء أكثر أهمية، حتى لو كان ذلك يعني فقدان بعض البيانات؟
- استخدِم CSS لتحسين تنسيق الصفحة، وأضِف سمة عنصر نائب إلى منطقة النص "dataChannelReceive".
- اختبِر الصفحة على جهاز جوّال.
ما تعلّمته
في هذه الخطوة، تعرّفت على كيفية:
- إنشاء اتصال بين جهازَين متصلَين عبر شبكة الند للند في WebRTC
- تبادُل البيانات النصية بين الشبكات المتصلة
يتوفّر إصدار كامل من هذه الخطوة في المجلد step-03.
مزيد من المعلومات
- قنوات بيانات WebRTC (قديمة بعض الشيء، ولكنها لا تزال مفيدة)
- لماذا تم اختيار SCTP لقناة بيانات WebRTC؟
التالي
لقد تعرّفت على كيفية تبادل البيانات بين الأجهزة على الصفحة نفسها، ولكن كيف يمكنك إجراء ذلك بين أجهزة مختلفة؟ أولاً، عليك إعداد قناة إرسال إشارات لتبادل رسائل البيانات الوصفية. تعرَّف على كيفية إجراء ذلك في الخطوة التالية.
7. إعداد خدمة إرسال إشارات لتبادل الرسائل
أهداف الدورة التعليمية
في هذه الخطوة، ستتعرّف على كيفية:
- استخدِم
npmلتثبيت تبعيات المشروع كما هو محدّد في package.json - شغِّل خادم Node.js واستخدِم node-static لعرض الملفات الثابتة.
- إعداد خدمة مراسلة على Node.js باستخدام Socket.IO
- ويمكنك استخدامها لإنشاء "غرف" وتبادل الرسائل.
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-04.
المفاهيم
لإعداد مكالمة WebRTC والحفاظ عليها، يحتاج عملاء WebRTC (الأقران) إلى تبادل البيانات الوصفية:
- معلومات المرشح (الشبكة).
- رسائل العرض والإجابة التي توفّر معلومات عن الوسائط، مثل درجة الدقة وبرامج الترميز
بعبارة أخرى، يجب تبادل البيانات الوصفية قبل أن يتم بث الصوت أو الفيديو أو البيانات من جهاز إلى آخر. تُعرف هذه العملية باسم الإشارة.
في الخطوات السابقة، يكون كائنَا RTCPeerConnection للمُرسِل والمُستلِم في الصفحة نفسها، لذا فإنّ "الإرسال" هو مسألة تمرير البيانات الوصفية بين الكائنات.
في التطبيقات الواقعية، يتم تشغيل RTCPeerConnection للمُرسِل والمُستلِم في صفحات ويب على أجهزة مختلفة، وتحتاج إلى طريقة تتيح لهما تبادل البيانات الوصفية.
لذلك، يمكنك استخدام خادم إرسال إشارات: وهو خادم يمكنه تمرير الرسائل بين برامج WebRTC (الأجهزة النظيرة). الرسائل الفعلية هي نص عادي: كائنات JavaScript تم تحويلها إلى سلاسل.
المتطلبات الأساسية: تثبيت Node.js
لتنفيذ الخطوات التالية من هذا الدرس التطبيقي حول الترميز (المجلدات من step-04 إلى step-06)، عليك تشغيل خادم على المضيف المحلي باستخدام Node.js.
يمكنك تنزيل Node.js وتثبيته مباشرةً من موقع Node.js الإلكتروني أو باستخدام مدير الحِزم المفضّل لديك.
بعد التثبيت، ستتمكّن من استيراد التبعيات المطلوبة للخطوات التالية (تشغيل npm install)، بالإضافة إلى تشغيل خادم مضيف محلي صغير لتنفيذ الدرس التطبيقي حول الترميز (تشغيل node index.js). ستتم الإشارة إلى هذه الأوامر لاحقًا عند الحاجة إليها.
لمحة عن التطبيق
يستخدم WebRTC واجهة برمجة تطبيقات JavaScript من جهة العميل، ولكن للاستخدام الفعلي، يتطلّب أيضًا خادم إرسال إشارات (مراسلة)، بالإضافة إلى خوادم STUN وTURN. مزيد من المعلومات حول البنية الأساسية لـ WebRTC
في هذه الخطوة، ستنشئ خادم إشارات بسيطًا في Node.js باستخدام وحدة Socket.IO Node.js ومكتبة JavaScript للمراسلة. ستكون الخبرة في Node.js وSocket.IO مفيدة، ولكنها ليست ضرورية، فمكونات المراسلة واضحة ومباشرة.
في هذا المثال، يتم تنفيذ الخادم (تطبيق Node.js) في index.js، ويتم تنفيذ العميل الذي يعمل عليه (تطبيق الويب) في index.html.
يتضمّن تطبيق Node.js في هذه الخطوة مهمتَين.
أولاً، يعمل كمنصة لإعادة توجيه الرسائل:
socket.on('message', function (message) {
log('Got message: ', message);
socket.broadcast.emit('message', message);
});
ثانيًا، يدير "غرف" محادثات الفيديو في WebRTC:
if (numClients === 0) {
socket.join(room);
socket.emit('created', room, socket.id);
} else if (numClients === 1) {
socket.join(room);
socket.emit('joined', room, socket.id);
io.sockets.in(room).emit('ready');
} else { // max two clients
socket.emit('full', room);
}
سيسمح تطبيق WebRTC الخاص بنا بحد أقصى اثنين من الأقران لمشاركة الغرفة.
HTML وJavaScript
عدِّل الملف index.html ليصبح على النحو التالي:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<script src="/socket.io/socket.io.js"></script>
<script src="js/main.js"></script>
</body>
</html>
لن يظهر لك أي شيء على الصفحة في هذه الخطوة: يتم تسجيل كل البيانات في وحدة تحكّم المتصفّح. (لعرض وحدة التحكّم في Chrome، اضغط على Ctrl-Shift-J أو Command-Option-J إذا كنت تستخدم جهاز Mac).
استبدِل js/main.js بما يلي:
'use strict';
var isInitiator;
window.room = prompt("Enter room name:");
var socket = io.connect();
if (room !== "") {
console.log('Message from client: Asking to join room ' + room);
socket.emit('create or join', room);
}
socket.on('created', function(room, clientId) {
isInitiator = true;
});
socket.on('full', function(room) {
console.log('Message from client: Room ' + room + ' is full :^(');
});
socket.on('ipaddr', function(ipaddr) {
console.log('Message from client: Server IP address is ' + ipaddr);
});
socket.on('joined', function(room, clientId) {
isInitiator = false;
});
socket.on('log', function(array) {
console.log.apply(console, array);
});
إعداد Socket.IO للتشغيل على Node.js
في ملف HTML، قد تكون رأيت أنك تستخدم ملف Socket.IO:
<script src="/socket.io/socket.io.js"></script>
في المستوى الأعلى من دليل work، أنشئ ملفًا باسم package.json يتضمّن المحتوى التالي:
{
"name": "webrtc-codelab",
"version": "0.0.1",
"description": "WebRTC codelab",
"dependencies": {
"node-static": "^0.7.10",
"socket.io": "^1.2.0"
}
}
هذا هو بيان التطبيق الذي يخبر Node Package Manager (npm) بتبعيات المشروع التي يجب تثبيتها.
لتثبيت التبعيات (مثل /socket.io/socket.io.js)، شغِّل الأمر التالي من وحدة سطر الأوامر الطرفية في دليل العمل:
npm install
من المفترض أن يظهر لك سجلّ تثبيت ينتهي على النحو التالي:

كما ترى، ثبّت npm التبعيات المحدّدة في package.json.
أنشئ ملفًا جديدًا باسم index.js في المستوى الأعلى من دليل work (وليس في دليل js) وأضِف الرمز التالي:
'use strict';
var os = require('os');
var nodeStatic = require('node-static');
var http = require('http');
var socketIO = require('socket.io');
var fileServer = new(nodeStatic.Server)();
var app = http.createServer(function(req, res) {
fileServer.serve(req, res);
}).listen(8080);
var io = socketIO.listen(app);
io.sockets.on('connection', function(socket) {
// convenience function to log server messages on the client
function log() {
var array = ['Message from server:'];
array.push.apply(array, arguments);
socket.emit('log', array);
}
socket.on('message', function(message) {
log('Client said: ', message);
// for a real app, would be room-only (not broadcast)
socket.broadcast.emit('message', message);
});
socket.on('create or join', function(room) {
log('Received request to create or join room ' + room);
var clientsInRoom = io.sockets.adapter.rooms[room];
var numClients = clientsInRoom ? Object.keys(clientsInRoom.sockets).length : 0;
log('Room ' + room + ' now has ' + numClients + ' client(s)');
if (numClients === 0) {
socket.join(room);
log('Client ID ' + socket.id + ' created room ' + room);
socket.emit('created', room, socket.id);
} else if (numClients === 1) {
log('Client ID ' + socket.id + ' joined room ' + room);
io.sockets.in(room).emit('join', room);
socket.join(room);
socket.emit('joined', room, socket.id);
io.sockets.in(room).emit('ready');
} else { // max two clients
socket.emit('full', room);
}
});
socket.on('ipaddr', function() {
var ifaces = os.networkInterfaces();
for (var dev in ifaces) {
ifaces[dev].forEach(function(details) {
if (details.family === 'IPv4' && details.address !== '127.0.0.1') {
socket.emit('ipaddr', details.address);
}
});
}
});
});
من الوحدة الطرفية لسطر الأوامر، نفِّذ الأمر التالي في دليل work:
node index.js
من المتصفّح، افتح localhost:8080.
في كل مرة تفتح فيها عنوان URL هذا، سيُطلب منك إدخال اسم الغرفة. للانضمام إلى الغرفة نفسها، اختَر اسم الغرفة نفسه في كل مرة، مثل "foo".
افتح علامة تبويب جديدة، وافتح localhost:8080 مرة أخرى. اختَر اسم الغرفة نفسه.
افتح localhost:8080 في علامة تبويب أو نافذة ثالثة. اختَر اسم الغرفة نفسه مرة أخرى.
تحقَّق من وحدة التحكّم في كل علامة تبويب: من المفترض أن يظهر لك التسجيل من رمز JavaScript السابق.
نقاط المكافأة
- ما هي آليات المراسلة البديلة التي قد تكون ممكنة؟ ما هي المشاكل التي قد تواجهها عند استخدام WebSocket "الخالص"؟
- ما هي المشاكل التي قد تنشأ عن توسيع نطاق هذا التطبيق؟ هل يمكنك تطوير طريقة لاختبار آلاف أو ملايين طلبات الغرف المتزامنة؟
- يستخدم هذا التطبيق طلب JavaScript للحصول على اسم غرفة. ابحث عن طريقة للحصول على اسم الغرفة من عنوان URL. على سبيل المثال، سيؤدي الرابط localhost:8080/foo إلى منح الغرفة الاسم
foo.
ما تعلّمته
في هذه الخطوة، تعرّفت على كيفية:
- استخدِم npm لتثبيت الموارد الاعتمادية للمشروع كما هو محدّد في package.json.
- شغِّل خادم Node.js لعرض الملفات الثابتة.
- إعداد خدمة مراسلة على Node.js باستخدام socket.io
- ويمكنك استخدامها لإنشاء "غرف" وتبادل الرسائل.
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-04.
مزيد من المعلومات
- مستودع Socket.io chat-example
- WebRTC في العالم الحقيقي: STUN وTURN والإشارات
- مصطلح "الإشارات" في WebRTC
التالي
تعرَّف على كيفية استخدام الإشارات للسماح لمستخدمَين بإنشاء اتصال مباشر بينهما.
8. الجمع بين اتصال النظير والإشارات
أهداف الدورة التعليمية
في هذه الخطوة، ستتعرّف على كيفية:
- تشغيل خدمة إشارات WebRTC باستخدام Socket.IO على Node.js
- استخدِم هذه الخدمة لتبادل بيانات WebRTC الوصفية بين الأجهزة النظيرة.
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-05.
استبدال HTML وJavaScript
استبدِل محتوى index.html بما يلي:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="/css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<div id="videos">
<video id="localVideo" autoplay muted></video>
<video id="remoteVideo" autoplay></video>
</div>
<script src="/socket.io/socket.io.js"></script>
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="js/main.js"></script>
</body>
</html>
استبدِل js/main.js بمحتوى step-05/js/main.js.
تشغيل خادم Node.js
إذا لم تكن تتابع هذا الدرس التطبيقي حول الترميز من دليل العمل، قد تحتاج إلى تثبيت التبعيات لمجلد step-05 أو مجلد العمل الحالي. نفِّذ الأمر التالي من دليل العمل:
npm install
بعد التثبيت، إذا لم يكن خادم Node.js قيد التشغيل، ابدأ تشغيله من خلال استدعاء الأمر التالي في دليل work:
node index.js
تأكَّد من استخدام إصدار index.js من الخطوة السابقة التي تنفّذ Socket.IO. لمزيد من المعلومات حول Node وSocket IO، يُرجى مراجعة قسم "إعداد خدمة إرسال إشارات لتبادل الرسائل".
من المتصفّح، افتح localhost:8080.
افتح localhost:8080 مرة أخرى في علامة تبويب أو نافذة جديدة. سيعرض أحد عناصر الفيديو البث المحلي من getUserMedia()، بينما سيعرض الآخر الفيديو "عن بُعد" الذي يتم بثه باستخدام RTCPeerconnection.
عرض التسجيل في وحدة تحكّم المتصفّح
نقاط المكافأة
- يتيح هذا التطبيق محادثات الفيديو بين شخصين فقط. كيف يمكنك تغيير التصميم لتمكين أكثر من شخص من مشاركة نفس غرفة محادثة الفيديو؟
- يحتوي المثال على اسم الغرفة foo المضمّن في الرمز البرمجي. ما هي أفضل طريقة لتفعيل أسماء الغرف الأخرى؟
- كيف يمكن للمستخدمين مشاركة اسم الغرفة؟ حاوِل إنشاء بديل لمشاركة أسماء الغرف.
- كيف يمكنك تغيير التطبيق
- التقِط صورة واحصل على البيانات منها باستخدام عنصر لوحة الرسم.
- تبادل بيانات الصور مع مستخدم عن بُعد
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-06.
آلية العمل
لقد تعرّفت سابقًا على كيفية تبادل الرسائل النصية باستخدام RTCDataChannel.
تتيح هذه الخطوة مشاركة ملفات كاملة: في هذا المثال، الصور التي تم التقاطها باستخدام "getUserMedia()".
في ما يلي الأجزاء الأساسية لهذه الخطوة:
- أنشئ قناة بيانات. يُرجى العِلم أنّك لا تضيف أي مصادر وسائط إلى اتصال النظير في هذه الخطوة.
- التقاط بث فيديو كاميرا الويب للمستخدم باستخدام
getUserMedia():
var video = document.getElementById('video');
function grabWebCamVideo() {
console.log('Getting user media (video) ...');
navigator.mediaDevices.getUserMedia({
video: true
})
.then(gotStream)
.catch(function(e) {
alert('getUserMedia() error: ' + e.name);
});
}
- عندما ينقر المستخدم على الزر Snap، يتم الحصول على لقطة (إطار فيديو) من بث الفيديو وعرضها في عنصر
canvas:
var photo = document.getElementById('photo');
var photoContext = photo.getContext('2d');
function snapPhoto() {
photoContext.drawImage(video, 0, 0, photo.width, photo.height);
show(photo, sendBtn);
}
- عندما ينقر المستخدم على الزر إرسال، يتم تحويل الصورة إلى وحدات بايت وإرسالها باستخدام قناة بيانات:
function sendPhoto() {
// Split data channel message in chunks of this byte length.
var CHUNK_LEN = 64000;
var img = photoContext.getImageData(0, 0, photoContextW, photoContextH),
len = img.data.byteLength,
n = len / CHUNK_LEN | 0;
console.log('Sending a total of ' + len + ' byte(s)');
dataChannel.send(len);
// split the photo and send in chunks of about 64KB
for (var i = 0; i < n; i++) {
var start = i * CHUNK_LEN,
end = (i + 1) * CHUNK_LEN;
console.log(start + ' - ' + (end - 1));
dataChannel.send(img.data.subarray(start, end));
}
// send the reminder, if any
if (len % CHUNK_LEN) {
console.log('last ' + len % CHUNK_LEN + ' byte(s)');
dataChannel.send(img.data.subarray(n * CHUNK_LEN));
}
}
- يحوّل الطرف المستلِم وحدات بايت رسالة قناة البيانات إلى صورة ويعرضها للمستخدم:
function receiveDataChromeFactory() {
var buf, count;
return function onmessage(event) {
if (typeof event.data === 'string') {
buf = window.buf = new Uint8ClampedArray(parseInt(event.data));
count = 0;
console.log('Expecting a total of ' + buf.byteLength + ' bytes');
return;
}
var data = new Uint8ClampedArray(event.data);
buf.set(data, count);
count += data.byteLength;
console.log('count: ' + count);
if (count === buf.byteLength) {
// we're done: all data chunks have been received
console.log('Done. Rendering photo.');
renderPhoto(buf);
}
};
}
function renderPhoto(data) {
var canvas = document.createElement('canvas');
canvas.width = photoContextW;
canvas.height = photoContextH;
canvas.classList.add('incomingPhoto');
// trail is the element holding the incoming images
trail.insertBefore(canvas, trail.firstChild);
var context = canvas.getContext('2d');
var img = context.createImageData(photoContextW, photoContextH);
img.data.set(data);
context.putImageData(img, 0, 0);
}
الحصول على الشفرة
استبدِل محتوى مجلد work بمحتوى step-06. يُفترض أن يظهر ملف index.html في work الآن على النحو التالي**:**
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="/css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<h2>
<span>Room URL: </span><span id="url">...</span>
</h2>
<div id="videoCanvas">
<video id="camera" autoplay></video>
<canvas id="photo"></canvas>
<script src="js/main.js"></script>
</body>
</html>
إذا لم تكن تتابع هذا الدرس التطبيقي حول الترميز من دليل العمل، قد تحتاج إلى تثبيت التبعيات لمجلد step-06 أو مجلد العمل الحالي. ما عليك سوى تنفيذ الأمر التالي من دليل العمل:
npm install
بعد التثبيت، إذا لم يكن خادم Node.js قيد التشغيل، ابدأ تشغيله من خلال استدعاء الأمر التالي من دليل العمل:
node index.js
تأكَّد من استخدام إصدار index.js الذي ينفّذ Socket.IO، وتذكَّر إعادة تشغيل خادم Node.js إذا أجريت تغييرات. لمزيد من المعلومات حول Node وSocket IO، يُرجى مراجعة قسم "إعداد خدمة إرسال إشارات لتبادل الرسائل".
إذا لزم الأمر، انقر على الزر سماح للسماح للتطبيق باستخدام كاميرا الويب.
سينشئ التطبيق معرّف غرفة عشوائيًا ويضيفه إلى عنوان URL. افتح عنوان URL من شريط العناوين في علامة تبويب متصفّح أو نافذة جديدة.
انقر على الزر التقاط وإرسال ثم انظر إلى منطقة "الواردة" في علامة التبويب الأخرى في أسفل الصفحة. ينقل التطبيق الصور بين علامات التبويب.
ينبغي أن تظهر لك على النحو التالي:

نقاط المكافأة
- كيف يمكنك تغيير الرمز البرمجي لإتاحة مشاركة أي نوع ملف؟
مزيد من المعلومات
- واجهة برمجة التطبيقات MediaStream Image Capture API: واجهة برمجة تطبيقات لالتقاط الصور والتحكّم في الكاميرات، وستتوفّر قريبًا في متصفّحك.
- واجهة MediaRecorder API لتسجيل الصوت والفيديو: عرض توضيحي، مستندات
ما تعلّمته
- كيفية التقاط صورة والحصول على البيانات منها باستخدام عنصر لوحة الرسم
- كيفية تبادل هذه البيانات مع مستخدم عن بُعد
تتوفّر نسخة كاملة من هذه الخطوة في المجلد step-06.
9. تهانينا
لقد أنشأت تطبيقًا لبث الفيديو وتبادل البيانات في الوقت الفعلي.
ما تعلّمته
في هذا الدرس التطبيقي حول الترميز، تعرّفت على كيفية:
- الحصول على فيديو من كاميرا الويب
- بث الفيديو باستخدام RTCPeerConnection
- بث البيانات باستخدام RTCDataChannel
- إعداد خدمة إرسال إشارات لتبادل الرسائل
- الجمع بين اتصال النظير والإشارات
- التقاط صورة ومشاركتها باستخدام قناة بيانات
الخطوات التالية
- اطّلِع على الرمز البرمجي والبنية لتطبيق AppRTC، وهو تطبيق دردشة WebRTC الأساسي: التطبيق، الرمز البرمجي.
- جرِّب العروض التوضيحية المباشرة من github.com/webrtc/samples.
مزيد من المعلومات
- تتوفّر مجموعة من المراجع لبدء استخدام WebRTC على webrtc.org.