Skip to content

Commit

Permalink
DetectRTC.js added. https://www.webrtc-experiment.com/DetectRTC/
Browse files Browse the repository at this point in the history
  • Loading branch information
@muaz-khan
muaz-khan committed Sep 16, 2014
0 parents commit 23a2a13
Show file tree
Hide file tree
Showing 4 changed files with 617 additions and 0 deletions.
281 changes: 281 additions & 0 deletions DetectRTC.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,281 @@
// Last time updated at Sep 16, 2014, 08:32:23

// Latest file can be found here: https://cdn.webrtc-experiment.com/DetectRTC.js

// Muaz Khan - www.MuazKhan.com
// MIT License - www.WebRTC-Experiment.com/licence
// Documentation - github.com/muaz-khan/WebRTC-Experiment/tree/master/DetectRTC
// ____________
// DetectRTC.js

// DetectRTC.hasWebcam (has webcam device!)
// DetectRTC.hasMicrophone (has microphone device!)
// DetectRTC.hasSpeakers (has speakers!)
// DetectRTC.isScreenCapturingSupported
// DetectRTC.isSctpDataChannelsSupported
// DetectRTC.isRtpDataChannelsSupported
// DetectRTC.isAudioContextSupported
// DetectRTC.isWebRTCSupported
// DetectRTC.isDesktopCapturingSupported
// DetectRTC.isMobileDevice
// DetectRTC.isWebSocketsSupported

// DetectRTC.DetectLocalIPAddress(callback)

// ----------todo: add
// DetectRTC.videoResolutions
// DetectRTC.screenResolutions

(function() {
// detect node-webkit
var isNodeWebkit = window.process && (typeof window.process == 'object') && window.process.versions && window.process.versions['node-webkit'];

var browser = getBrowserInfo();

// is this a chromium browser (opera or chrome)
var isChrome = browser.name == 'Chrome';
var isFirefox = browser.name == 'Firefox';

window.DetectRTC = {
browser: browser,
hasMicrophone: navigator.getMediaDevices || navigator.enumerateDevices ? false : 'unable to detect',
hasSpeakers: navigator.getMediaDevices || navigator.enumerateDevices ? false : 'unable to detect',
hasWebcam: navigator.getMediaDevices || navigator.enumerateDevices ? false : 'unable to detect',

isWebRTCSupported: !!window.webkitRTCPeerConnection || !!window.mozRTCPeerConnection,
isAudioContextSupported: (!!window.AudioContext || !!window.webkitAudioContext) && !!AudioContext.prototype.createMediaStreamSource,

isScreenCapturingSupported: (isFirefox && browser.version >= 33) ||
(isChrome && browser.version >= 26 && (isNodeWebkit ? true : location.protocol == 'https:')),

isDesktopCapturingSupported: (isFirefox && browser.version >= 33) || (isChrome && browser.version >= 34) || isNodeWebkit || false,

isSctpDataChannelsSupported: isFirefox || (isChrome && browser.version >= 25),
isRtpDataChannelsSupported: isChrome && browser.version >= 31,
isMobileDevice: !!navigator.userAgent.match(/Android|iPhone|iPad|iPod|BlackBerry|IEMobile/i),
isWebSocketsSupported: 'WebSocket' in window && 2 === window.WebSocket.CLOSING
};

var isOpera = !!window.opera || navigator.userAgent.indexOf(' OPR/') >= 0;
var isFirefox = typeof InstallTrigger !== 'undefined';
var isSafari = Object.prototype.toString.call(window.HTMLElement).indexOf('Constructor') > 0;
var isChrome = !!window.chrome && !isOpera;
var isIE = !!document.documentMode;

var isMobileDevice = !!navigator.userAgent.match(/Android|iPhone|iPad|iPod|BlackBerry|IEMobile/i);

// detect node-webkit
var isNodeWebkit = !!(window.process && (typeof window.process == 'object') && window.process.versions && window.process.versions['node-webkit']);

DetectRTC.browser = {
isFirefox: isFirefox,
isChrome: isChrome,
isMobileDevice: isMobileDevice,
isNodeWebkit: isNodeWebkit,
isSafari: isSafari,
isIE: isIE,
isOpera: isOpera,
name: browser.name,
version: browser.version
};

var osName = 'Unknown OS';
if (navigator.appVersion.indexOf('Win') != -1) osName = 'Windows';
if (navigator.appVersion.indexOf('Mac') != -1) osName = 'MacOS';
if (navigator.appVersion.indexOf('X11') != -1) osName = 'UNIX';
if (navigator.appVersion.indexOf('Linux') != -1) osName = 'Linux';
DetectRTC.osName = osName;

DetectRTC.MediaDevices = [];

// http://dev.w3.org/2011/webrtc/editor/getusermedia.html#mediadevices
// todo: switch to enumerateDevices when landed in canary.
function CheckDeviceSupport(callback) {
// This method is useful only for Chrome!

// Firefox seems having no support of enumerateDevices feature.
// Though there seems some clues of 'navigator.getMediaDevices' implementation.
if (isFirefox) {
callback && callback();
return;
}

if (!navigator.getMediaDevices && window.MediaStreamTrack && MediaStreamTrack.getSources) {
navigator.getMediaDevices = MediaStreamTrack.getSources.bind(MediaStreamTrack);
}

// if still no 'getMediaDevices'; it MUST be Firefox!
if (!navigator.getMediaDevices) {
log('navigator.getMediaDevices is undefined.');
// assuming that it is older chrome or chromium implementation
if (isChrome) {
DetectRTC.hasMicrophone = true;
DetectRTC.hasSpeakers = true;
DetectRTC.hasWebcam = true;
}

callback && callback();
return;
}

navigator.getMediaDevices(function(devices) {
devices.forEach(function(device) {
// if it is MediaStreamTrack.getSources
if (device.kind == 'audio') {
device.kind = 'audioinput';
}

if (device.kind == 'video') {
device.kind = 'videoinput';
}

if (!device.deviceId) {
device.deviceId = device.id;
}

if (!device.id) {
device.id = device.deviceId;
}

DetectRTC.MediaDevices.push(device);

if (device.kind == 'audioinput' || device.kind == 'audio') {
DetectRTC.hasMicrophone = true;
}

if (device.kind == 'audiooutput') {
DetectRTC.hasSpeakers = true;
}

if (device.kind == 'videoinput' || device.kind == 'video') {
DetectRTC.hasWebcam = true;
}

// there is no 'videoouput' in the spec.
});

if (callback) callback();
});
}

// check for microphone/camera support!
CheckDeviceSupport();
DetectRTC.load = CheckDeviceSupport;

function getBrowserInfo() {
var nVer = navigator.appVersion;
var nAgt = navigator.userAgent;
var browserName = navigator.appName;
var fullVersion = '' + parseFloat(navigator.appVersion);
var majorVersion = parseInt(navigator.appVersion, 10);
var nameOffset, verOffset, ix;

// In Opera, the true version is after 'Opera' or after 'Version'
if ((verOffset = nAgt.indexOf('Opera')) != -1) {
browserName = 'Opera';
fullVersion = nAgt.substring(verOffset + 6);
if ((verOffset = nAgt.indexOf('Version')) != -1)
fullVersion = nAgt.substring(verOffset + 8);
}
// In MSIE, the true version is after 'MSIE' in userAgent
else if ((verOffset = nAgt.indexOf('MSIE')) != -1) {
browserName = 'IE';
fullVersion = nAgt.substring(verOffset + 5);
}
// In Chrome, the true version is after 'Chrome'
else if ((verOffset = nAgt.indexOf('Chrome')) != -1) {
browserName = 'Chrome';
fullVersion = nAgt.substring(verOffset + 7);
}
// In Safari, the true version is after 'Safari' or after 'Version'
else if ((verOffset = nAgt.indexOf('Safari')) != -1) {
browserName = 'Safari';
fullVersion = nAgt.substring(verOffset + 7);
if ((verOffset = nAgt.indexOf('Version')) != -1)
fullVersion = nAgt.substring(verOffset + 8);
}
// In Firefox, the true version is after 'Firefox'
else if ((verOffset = nAgt.indexOf('Firefox')) != -1) {
browserName = 'Firefox';
fullVersion = nAgt.substring(verOffset + 8);
}
// In most other browsers, 'name/version' is at the end of userAgent
else if ((nameOffset = nAgt.lastIndexOf(' ') + 1) < (verOffset = nAgt.lastIndexOf('/'))) {
browserName = nAgt.substring(nameOffset, verOffset);
fullVersion = nAgt.substring(verOffset + 1);
if (browserName.toLowerCase() == browserName.toUpperCase()) {
browserName = navigator.appName;
}
}
// trim the fullVersion string at semicolon/space if present
if ((ix = fullVersion.indexOf(';')) != -1) fullVersion = fullVersion.substring(0, ix);
if ((ix = fullVersion.indexOf(' ')) != -1) fullVersion = fullVersion.substring(0, ix);

majorVersion = parseInt('' + fullVersion, 10);
if (isNaN(majorVersion)) {
fullVersion = '' + parseFloat(navigator.appVersion);
majorVersion = parseInt(navigator.appVersion, 10);
}

return {
fullVersion: fullVersion,
version: majorVersion,
name: browserName
};
}

// via: http://net.ipcalf.com/
DetectRTC.DetectLocalIPAddress = function(callback) {
var RTCPeerConnection = window.webkitRTCPeerConnection || window.mozRTCPeerConnection;

(function() {
var rtc = new RTCPeerConnection({
iceServers: []
});
if (window.mozRTCPeerConnection) { // FF needs a channel/stream to proceed
rtc.createDataChannel('', {
reliable: false
});
};

rtc.onicecandidate = function(evt) {
if (evt.candidate) grepSDP(evt.candidate.candidate);
};
rtc.createOffer(function(offerDesc) {
grepSDP(offerDesc.sdp);
rtc.setLocalDescription(offerDesc);
}, function(e) {
console.warn("offer failed", e);
});


var addrs = Object.create(null);
addrs["0.0.0.0"] = false;

function updateDisplay(newAddr) {
if (newAddr in addrs) return;
else addrs[newAddr] = true;
var displayAddrs = Object.keys(addrs).filter(function(k) {
return addrs[k];
});
callback(displayAddrs.join(" or perhaps ") || "n/a");
}

function grepSDP(sdp) {
var hosts = [];
sdp.split('\r\n').forEach(function(line) { // c.f. http://tools.ietf.org/html/rfc4566#page-39
if (~line.indexOf("a=candidate")) { // http://tools.ietf.org/html/rfc4566#section-5.13
var parts = line.split(' '), // http://tools.ietf.org/html/rfc5245#section-15.1
addr = parts[4],
type = parts[7];
if (type === 'host') updateDisplay(addr);
} else if (~line.indexOf("c=")) { // http://tools.ietf.org/html/rfc4566#section-5.7
var parts = line.split(' '),
addr = parts[2];
updateDisplay(addr);
}
});
}
})();
}
})();
83 changes: 83 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
## [DetectRTC.js](https://github.com/muaz-khan/DetectRTC) / [Demo](https://www.webrtc-experiment.com/DetectRTC/) [![npm](https://img.shields.io/npm/v/detectrtc.svg)](https://npmjs.org/package/detectrtc) [![downloads](https://img.shields.io/npm/dm/detectrtc.svg)](https://npmjs.org/package/detectrtc)

A tiny JavaScript library that can be used to detect WebRTC features e.g. system having speakers, microphone or webcam, screen capturing is supported, number of audio/video devices etc.

It is <a href="https://www.webrtc-experiment.com/licence/">MIT Licenced</a>, which means that you can use it in any commercial/non-commercial product, free of cost.

```
npm install detectrtc
```

To use it:

```htm
<script src="./node_modules/detectrtc/DetectRTC.js"></script>
```

## Link the library

```html
<script src="//cdn.webrtc-experiment.com/DetectRTC.js"></script>
```

<img src="https://cdn.webrtc-experiment.com/images/DetectRTC.png" style="width:100%;" />

## How to use it?

```html
<script src="//cdn.webrtc-experiment.com/DetectRTC.js"></script>
```

## List of available detections

```javascript
DetectRTC.load(function() {
// DetectRTC.hasWebcam (has webcam device!)
// DetectRTC.hasMicrophone (has microphone device!)
// DetectRTC.hasSpeakers (has speakers!)
// DetectRTC.isScreenCapturingSupported
// DetectRTC.isSctpDataChannelsSupported
// DetectRTC.isRtpDataChannelsSupported
// DetectRTC.isAudioContextSupported
// DetectRTC.isWebRTCSupported
// DetectRTC.isDesktopCapturingSupported
// DetectRTC.isMobileDevice
// DetectRTC.isWebSocketsSupported

// DetectRTC.osName

// DetectRTC.browser.name
// DetectRTC.browser.version
// DetectRTC.browser.isChrome
// DetectRTC.browser.isFirefox
// DetectRTC.browser.isOpera
// DetectRTC.browser.isIE
// DetectRTC.browser.isSafari

// DetectRTC.DetectLocalIPAddress(callback)
});
```

## Why `load` method?

If you're not detecting audio/video input/outupt devices then you can skip this method.

`DetectRTC.load` simply makes sure that all devices are captured and valid result is set for relevant properties.

## Demo

* https://www.webrtc-experiment.com/DetectRTC/

## Credits

[Muaz Khan](https://github.com/muaz-khan):

1. Personal Webpage: http://www.muazkhan.com
2. Email: [email protected]
3. Twitter: https://twitter.com/muazkh and https://twitter.com/WebRTCWeb
4. Google+: https://plus.google.com/+WebRTC-Experiment
5. Facebook: https://www.facebook.com/WebRTC

## License

[DetectRTC.js](https://github.com/muaz-khan/DetectRTC) is released under [MIT licence](https://www.webrtc-experiment.com/licence/) . Copyright (c) [Muaz Khan](https://plus.google.com/+MuazKhan).
Loading

0 comments on commit 23a2a13

Please sign in to comment.