Нет описания

eddieherm d1611d8f52 Fix minor spelling error in API docs		5 лет назад
.github	220197fcda Create FUNDING.yml	5 лет назад
dist	72e7c176c8 don't close connection when iceConnectionState changed to disconnected	5 лет назад
docs	d1611d8f52 Fix minor spelling error in API docs	5 лет назад
lib	b19135cf59 remove unused file	5 лет назад
test	237cf737b4 fix tests	5 лет назад
.gitignore	83f2638886 add extra fields to package.json	5 лет назад
LICENSE	fc7c88d3e3 Update LICENSE	10 лет назад
README.md	db40904ec5 update doc	5 лет назад
changelog.md	72e7c176c8 don't close connection when iceConnectionState changed to disconnected	5 лет назад
index.d.ts	450b151468 rename methods	5 лет назад
package-lock.json	702e63d075 update devDeps	5 лет назад
package.json	702e63d075 update devDeps	5 лет назад
tsconfig.json	a4791aa63a upgrade packages versions	5 лет назад
webrtc-adapter.d.ts	dd1f88d84a refactoring	5 лет назад

PeerJS: Simple peer-to-peer with WebRTC

https://t.me/joinchat/ENhPuhTvhm8WlIxTjQf7Og

PeerJS provides a complete, configurable, and easy-to-use peer-to-peer API built on top of WebRTC, supporting both data channels and media streams.

Setup

Include the library

with npm:

    `npm install peerjs`
and the usage:

  import Peer from 'peerjs';

Create a Peer

const peer = new Peer('pick-an-id'); 
// You can pick your own id or omit the id if you want to get a random one from the server.

Data connections

Connect

const conn = peer.connect('another-peers-id');
conn.on('open', () => {
  conn.send('hi!');
});

Receive

peer.on('connection', (conn) => {
  conn.on('data', (data) => {
    // Will print 'hi!'
    console.log(data);
  });
  conn.on('open', () => {
    conn.send('hello!');
  });
});

Media calls

Call

navigator.mediaDevices.getUserMedia({video: true, audio: true}, (stream) => {
  const call = peer.call('another-peers-id', stream);
  call.on('stream', (remoteStream) => {
    // Show stream in some <video> element.
  });
}, (err) => {
  console.error('Failed to get local stream', err);
});

Answer

peer.on('call', (call) => {
  navigator.mediaDevices.getUserMedia({video: true, audio: true}, (stream) => {
    call.answer(stream); // Answer the call with an A/V stream.
    call.on('stream', (remoteStream) => {
      // Show stream in some <video> element.
    });
  }, (err) => {
    console.error('Failed to get local stream', err);
  });
});

Running tests

npm test

Browsers support

FirefoxChromeSafari

last 4 versions last 4 versions 12.1+

Safari

Safari supports only string data when sending via DataConnection. Use JSON serialization type if you want to communicate with Safari. By default, DataConnection uses Binary serialization type.

FAQ

Q. I have a message Critical dependency: the request of a dependency is an expression in browser's console

A. The message occurs when you use PeerJS with Webpack. It is not critical! It relates to Parcel https://github.com/parcel-bundler/parcel/issues/2883 We'll resolve it when updated to Parcel V2.