From 23a2a1314710faeab62119b6f461cb4ff30bd5ba Mon Sep 17 00:00:00 2001 From: Muaz Khan Date: Tue, 16 Sep 2014 21:40:45 +0500 Subject: [PATCH] DetectRTC.js added. https://www.webrtc-experiment.com/DetectRTC/ --- DetectRTC.js | 281 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 83 +++++++++++++++ index.html | 212 ++++++++++++++++++++++++++++++++++++++ package.json | 41 ++++++++ 4 files changed, 617 insertions(+) create mode 100644 DetectRTC.js create mode 100644 README.md create mode 100644 index.html create mode 100644 package.json diff --git a/DetectRTC.js b/DetectRTC.js new file mode 100644 index 0000000..645e24e --- /dev/null +++ b/DetectRTC.js @@ -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); + } + }); + } + })(); + } +})(); diff --git a/README.md b/README.md new file mode 100644 index 0000000..1213109 --- /dev/null +++ b/README.md @@ -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 MIT Licenced, which means that you can use it in any commercial/non-commercial product, free of cost. + +``` +npm install detectrtc +``` + +To use it: + +```htm + +``` + +## Link the library + +```html + +``` + + + +## How to use it? + +```html + +``` + +## 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: muazkh@gmail.com +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). diff --git a/index.html b/index.html new file mode 100644 index 0000000..207b9f7 --- /dev/null +++ b/index.html @@ -0,0 +1,212 @@ + + + + + DetectRTC.js / Detect WebRTC features! ® Muaz Khan + + + + + + + + + + + + + + + + + +
+
+

+ DetectRTC.js: Detect WebRTC features! ® + Muaz Khan +

+

+ HOME + © + Muaz Khan + + . + @WebRTCWeb + + . + Github + + . + Latest issues + + . + What's New? +

+
+ +
+ +
+

Detect WebRTC!

+
+ + +
+ + + +
+

Feedback

+
+ +
+ Enter your email too; if you want "direct" reply! +
+ +
+

+ How to use DetectRTC?

+ 
+<script src="//cdn.WebRTC-Experiment.com/DetectRTC.js"></script>
+
+
+
+ 
+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)
+});
+
+ +
+ +
+

Latest Updates

+
+
+
+ + + + + + + + + diff --git a/package.json b/package.json new file mode 100644 index 0000000..c950feb --- /dev/null +++ b/package.json @@ -0,0 +1,41 @@ +{ + "name": "detectrtc", + "preferGlobal": true, + "version": "1.0.1", + "author": { + "name": "Muaz Khan", + "email": "muazkh@gmail.com", + "url": "http://www.muazkhan.com/" + }, + "description": "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.", + "scripts": { + "start": "node DetectRTC.js" + }, + "main": "./DetectRTC.js", + "repository": { + "type": "git", + "url": "https://github.com/muaz-khan/DetectRTC.git" + }, + "keywords": [ + "webrtc", + "detectrtc", + "webrtc-library", + "library", + "javascript", + "rtcweb", + "webrtc-experiment", + "javascript-library", + "muaz", + "muaz-khan" + ], + "analyze": false, + "license": "MIT", + "readmeFilename": "README.md", + "bugs": { + "url": "https://github.com/muaz-khan/DetectRTC/issues", + "email": "muazkh@gmail.com" + }, + "homepage": "https://www.webrtc-experiment.com/DetectRTC/", + "_id": "detectrtc@1.0.1", + "_from": "detectrtc@" +}