相信JS-SDK是相信生活频道面向网页开发者提供的基于相信内的网页开发工具包。 通过使用相信JS-SDK，网页开发者可借助相信高效地使用拍照、选图、视频、会议室、位置等手机系统的能力， 同时可以直接使用相信分享、扫一扫、打开文件等相信特有的功能，为相信用户提供更优质的网页体验。 此文档面向网页开发者介绍相信JS-SDK如何使用及相关注意事项。

在需要调用JS-SDK接口的页面引入如下JS文件： CivetJsSDK-latest.min.js。 你可通过以下代码调用JsSDK。 <!--引用最新版--> <script src="//civetinterface.foxconn.com/Scripts/CivetJsSDK-latest.min.js"></script>
若要防止此JS文件因升级或被篡改，可给此文件加上签名。 <!--防篡改--> <script src="//civetinterface.foxconn.com/Scripts/CivetJsSDK-2.0.5.min.js" crossorigin="anonymous" integrity="sha256-11sKM0uGT6l1/AxEwCaiTUPleeL6qJSyP8q/pkhyLuc="></script> 所有接口通过cm对象来调用，参数是一个对象，每个接口本身有需要传的参数。 各接口具体调用说明如下：

目录 [隐藏]
是否相信环境 拍照、视频、选择图片 预览图片 显示视频 显示频道号信息页 创建聊天会议室 日历 打开地图 获取地理位置接口 扫一扫 打开文件 隐藏/显示右上角菜单 关闭当前网页窗口 隐藏/显示功能按钮 设定屏幕方向 进入单聊界面 去掉相信手机端网页缓存 手机页面水印

var useCivet = cm.useCivet; if(useCivet == true) { alert("是相信环境。"); } else { alert("不是相信环境。"); } cm.chooseImage({ type: "all", //选填字段，来源类型，默认为all。值有：image(选择图片)/record(录制视频)/camera(拍照)/all(以上三种） maxCount: "1",//选填字段，选择图片时一次最多选几张，默认为9。 success: function (res) { //调用成功时执行的回调函数 var localIds = res.localIds; //返回选定照片的本地ID列表,localId可以作为img标签的src属性显示图片 var isVedio = res.isVedio; //是否为视频(字符串类型,“false”/“true”) }, deal: function(){ ; } }); cm.previewImage({ urls: urls, //需要预览的图片链接列表（字符串数组）,为必填项 current: current, //当前显示的图片链接,为必填项 dealGif: true, //是否需要处理Gif动画图片,true: 是, false: 否 fail: function (errmsg) { //调用失败时执行的回调函数 //参数errmsg：失败原因，字符串型 }, deal: function (url){ //在非相信环境下处理方法 //参数url：当前图片的url } }); cm.previewVideo({ url: url, //当前显示的视频链接,为必填项 close: function(playSec, StaySec){ //playSec:播放时间，StaySec：停留时间 }, deal: function (url){ //在非相信环境下处理方法 //参数url：当前图片的url } }); cm.showPublicNoInfo({ civetno: civetno, //生活频道号(字符串类型),为必填项 civetType: civetType //生活频道类型(字符串类型, 1表示服务台/广播台, 2表示关注台) }); cm.conference({ confName: confName, //会议名称(字符串类型) confImg: confImg, //会议图标链接 confRemark: confRemark, //会议主题说明(字符串类型) confUrl: confUrl, //会议说明网址 confId: confId, //会议ID(字符串类型;若新开会议室此值为空,若进入原会议室则将此值赋原会议ID) creator：creator, //生活频道号(字符串类型),为必填项 peoples：peoples, //指定参加会议人员的工号（为可选项，若不填写则需手动添加参加会议人员，若填写则系统自动添加指定的人员），工号之间用英文状态下的逗号“,”隔开，如Test01,Test02,Test03 fail: function (errmsg) { //调用失败时执行的回调函数 //参数errmsg：失败原因，字符串型 } }); 生活频道账号将系统传出的会议室创建结果，通过接口，以如下消息格式返回给网页开发者： <xml> <MsgType>conference</MsgType> <SendTime>2014-01-01T14:00:00</SendTime> <ToCivetNo>CivetDeve</ToCivetNo> //接收人，一个生活频道账号 <Event>1</Event> //1表示成功，2表示失败 <EventKey>会议室ID,会议室名称</EventKey> </xml> cm.calender({ defaultDate: defaultDate, //默认日期,格式：yyyy-MM-dd success: function (res) { //调用成功时执行的回调函数 var date = res.date; //返回的日期,格式：yyyy-MM-dd } }); cm.showLocation([ //需打开的地图组 {imgUrl: imgUrl1, name: name1, x: x1, y: y1 }, {imgUrl: imgUrl2, name: name2, x: x2, y: y2 }, ...... {imgUrl: imgUrln, name: namen, x: xn, y: yn } ]); //imgUrl,头像Url; name,地图名称; x, 经度; y, 纬度

用户从地图上选择当前位置

cm.getLocation({ success: function (res) { //调用成功时执行的回调函数 var latitude = res.latitude; //纬度，浮点数，范围为90 ~ -90 var longitude = res.longitude; //经度，浮点数，范围为180 ~ -180 var name = res.name; //位置名 var address = res.address; //地址详情说明 var speed = res.speed; // 速度，以米/每秒计 var accuracy = res.accuracy; //位置精度 } });

读取用户的GPS信息

cm.getGPS({ modal: true, //是否模态（操作时即锁屏），默认为true，4.5版本支持非模态（即：false) success: function (res) { //调用成功时执行的回调函数 var lat = res.lat; //纬度，浮点数，范围为90 ~ -90 var lng = res.lng; //经度，浮点数，范围为180 ~ -180 var code = res.code; //状态值，1：成功，0：失败 } }); cm.scanQRCode({ success: function (res) { //调用成功时执行的回调函数 var resultStr = res.resultStr; //扫码返回的结果 } }); cm.openFile({ type:type, //文件类型 url:url, //文件路径 deal: function (url){ //在非相信环境下处理方法 //参数url：当前文件的url } }); //隐藏右上角菜单 cm.hideOptionMenu(); //显示右上角菜 cm.showOptionMenu(); cm.closeWindow(); //隐藏功能按钮 cm.hideMenuItems({ menuList: ["按钮Code_1","按钮Code_2",……] }); //显示功能按钮 cm.showMenuItems({ menuList: ["按钮Code_1","按钮Code_2",……] }); //您也可以通过，以下方法对机密页面转发、分享复制链接等涉及安全的菜单全部隐藏 cm.secretPage(true); //显示等涉及安全的菜单 cm.secretPage(false); 注：1.1版新增功能。
按钮Code值如下：
调整字体: menuItem:setFont
复制链接: menuItem:copyUrl
在浏览器中打开: menuItem:openWithBrowser
发送给朋友: menuItem:share:appMessage
分享到朋友圈: menuItem:share:timeline
cm.setScreen({ direction: 0 }) //0.竖屏(默认) 1.横屏 2.随手机方向 注：1.1版新增功能。
cm.chat({ civetno: civetno, //个人相信号,为必填项 fail: function (errmsg) { //调用失败时执行的回调函数 //参数errmsg：失败原因，字符串型 } });