3.0.1 • Published 5 years ago

ar-detect v3.0.1

Weekly downloads
2
License
MIT
Repository
github
Last release
5 years ago

一、概述

简介

anyRTC RTC 检测工具提供以下检测功能:

  • 浏览器webRTC检测
  • 获取浏览器信息、版本、以及操作系统
  • 分辨率检测
  • 音频大小检测
  • 获取设备信息
  • 媒体视频窗口截图等等

Dome体验

检测工具为您的产品带来更好的用户体验。

源码GitHub

源码仅供开发者参考,适用于SDK调试,便于快速集成。

二、集成指南

适用范围

本集成文档适用于Web ArDetect SDK 3.0.0及以上版本。

准备环境

支持 Chrome、IE 10 +、Firefox、Safari 等主流浏览器环境

导入SDK

npm 市场
npm install ar-detect --save-dev

import ArDetect from 'ar-detect';
  • 安装或更新至最新版本:
npm install ar-detect@latest --save-dev

import ArDetect from 'ar-detect';
js 引用
<script src="yourAssetsPath/ArDetect.版本号.js"></script>

三、API接口文档

ArDetect对象简介

示例
ArDetect = {
	browserInfo,//浏览器信息
	OSName,//操作系统信息
	checkRTCSupport(),//检测浏览器是否支持webRTC
	...
};

检测浏览器是否支持webRTC

示例
ArDetect.checkRTCSupport();

返回值

true or false

获取设备列表

ArDetect.getDevices(deviceType).then(data => {
	console.log(data);
}).catch(err => {
	console.log('getDevice error', err);
})
参数
参数名类型描述
deviceTypestring设备类型(非必选):'videoinput' 摄像头、'audioinput'麦克风、'audiooutput'扬声器

检测分辨率是否支持

示例
ArDetect.checkResolution(resolutionOptions); 
参数
参数名类型描述
resolutionOptionsobjectwidth视频宽度height视频高度
说明

检测本地摄像头是否支持采集设定的分辨率。

返回值

Promise对象。

创建本地预览流(打开摄像头)

示例
ArDetect.createStream(constraints)
	.then(e => {
		//do something
	})
	.catch(err => {

	});

参数

参数名类型描述
constraintsobject采集媒体配置(非必填)

constraints

参数名类型描述
videoobjectenable是否打开摄像头deviceId指定设备,deviceId 通过getDevices 接口获取
audioobjectenable是否打开摄像头deviceId指定设备,deviceId 通过getDevices 接口获取

说明

返回Promise对象。

释放采集设备

示例
ArDetect.releaseStream();

检测媒体流音频

示例
let detectContext = ArDetect.detectMediaStreamVolum(stream, callback);
参数
参数名类型描述
streammediaStream媒体流对象,例如:createStream返回的媒体流
callbackfunction获取媒体流音频大小成功的回调。参数为音频大小0~100
说明

获取指定媒体流的音频大小。

返回值

检测音频大小的上下文对象detectContext,结束音频检测时传入。

取消媒体流音频检测

示例
ArDetect.endDetectMediaStreamVolume(detectContext);
参数
参数名类型描述
audioContextobjectdetectMediaStreamVolum时返回的上下文对象
说明

该方法需要在detectMediaStreamVolum调用之后才能调用。

选择音频输出设备

示例
ArDetect.attachSinkId(element, sinkId);
参数
参数名类型描述
elementelementaudioDOM对象
sinkIdstring扬声器的设备id(audiooutput), 通过getDeivces('audiooutput')获得
说明

获得设备列表,选择指定设备播放音频。

返回值

Promise

捕捉视频窗口截图

示例
ArDetect.takeMediaStreamSnapshot(videoElement, fileName);
参数
参数名类型描述
enableelementvideoDOM对象
fileNamestring文件名,下载到本地的文件名称

四、更新日志

Version 3.0.1 (2019-05-27)

  • 更新文档

Version 3.0.0 (2019-01-24)

  • SDK版本升级3.0,API接口变更,更加简洁规范