Files
Testing/videocall1/text-chat/README.md
sean 0e8a8b3028
Some checks failed
deploy-testing / deploy (push) Has been cancelled
Initial testing snapshot
2026-11-17 16:15:01 -05:00

149 lines
3.6 KiB
Markdown

#### WebRTC Text Chat i.e. Data Sharing / [Demo](https://www.webrtc-experiment.com/text-chat/)
`DataConnection.js` library lets you:
1. Share file of any size
2. Share text message of any length
3. Text data regardless of the size and type
=
#### First Step: Link the library
```html
<script src="https://www.webrtc-experiment.com/data-connection.js"></script>
```
=
#### Last Step: Start using it!
```javascript
var connection = new DataConnection( /* 'optional::firebase-channel' */);
// check pre-established connections
connection.check('connection-name');
document.getElementById('setup-new-connection').onclick = function() {
connection.setup('connection-name');
};
```
=
#### Text Chat i.e. Text Sharing
```javascript
connection.send('longest possible text message');
```
You may want to share direct messages:
```javascript
connection.channels['user-id'].send('longest possible text message');
```
=
#### Errors Handling
```javascript
// error to open data connection
connection.onerror = function(event, userid) {}
// data ports suddenly dropped
connection.onclose = function(event, userid) {}
```
=
#### Custom user-ids?
```javascript
connection.userid = 'username';
```
=
#### Custom signaling channel?
You can use each and every signaling channel:
1. SIP-over-WebSockets
2. WebSocket over Node.js/PHP/etc.
3. Socket.io over Node.js/etc.
4. XMPP/etc.
5. XHR-POST-ing
```javascript
connection.openSignalingChannel = function(callback) {
return io.connect().on('message', callback);
};
```
If you want to write `socket.io over node.js`; here is the server code:
```javascript
io.sockets.on('connection', function (socket) {
socket.on('message', function (data) {
socket.broadcast.emit('message', data);
});
});
```
That's it! Isn't it easiest method ever!
Want to use `Firebase` for signaling?
```javascript
// "chat" is your firebase id
connection.firebase = 'chat';
```
Want to use XHR, WebSockets, SIP, XMPP, etc. for signaling? Read [this post](https://github.com/muaz-khan/WebRTC-Experiment/issues/56#issuecomment-20090650).
=
#### Want to manually join rooms?
```javascript
connection.onconnection = function(room) {
var button = document.createElement('button');
button.onclick = function() {
connection.join(room);
};
};
```
`onconnection` is called for each new data connection; and `join` method allows you manually join previously created connections.
=
#### If someone leaves...
Participants' presence can be detected using `onuserleft`:
```javascript
connection.onuserleft = function(userid) {
console.debug(userid, 'left');
};
```
=
#### Browser Support
This [DataConnection.js](https://www.webrtc-experiment.com/data-connection.js) library is compatible to following web-browsers:
| Browser | Support |
| ------------- |-------------|
| Firefox | [Stable](http://www.mozilla.org/en-US/firefox/new/) / [Aurora](http://www.mozilla.org/en-US/firefox/aurora/) / [Nightly](http://nightly.mozilla.org/) |
| Google Chrome | [Stable](https://www.google.com/intl/en_uk/chrome/browser/) / [Canary](https://www.google.com/intl/en/chrome/browser/canary.html) / [Beta](https://www.google.com/intl/en/chrome/browser/beta.html) / [Dev](https://www.google.com/intl/en/chrome/browser/index.html?extra=devchannel#eula) |
| Android | [Chrome Beta](https://play.google.com/store/apps/details?id=com.chrome.beta&hl=en) |
=
#### License
[DataConnection.js](https://www.webrtc-experiment.com/data-connection.js) is released under [MIT licence](https://www.webrtc-experiment.com/licence/) . Copyright (c) 2013 [Muaz Khan](https://plus.google.com/100325991024054712503).