前言

随着智能硬件的普及，手机，平板，PC甚至路边的电子广告牌，现代浏览器已经无处不在。在浏览器里编织出我们自己的一片天地已经轻车熟路，但是这还不够，H5赋予了浏览器太多的新特性，等待我们去使用。这篇文章介绍利用手机浏览器的罗盘API，在PC的浏览器实时地绘制一个3D盒模型。

这种炫酷的玩法叫做“多屏互动”，就像是把手机当做游戏手柄，PC显示器当做电视机，不过这些都是在浏览器里实现的。

先上效果图

(测试机是刷了小米系统的裂了屏幕的HTC霹雳2+Chrome浏览器)

源码请戳这里：https://coding.net/u/OverTree/p/webSocketDemo/git

本地测试过程：

在PC上，使用命令 node index.js，自动打开项目主页。（请关闭ADsafe，如有虚拟机，请停用虚拟网卡）
创建一个“房间”并自动进入“房间”。
用手机扫描“房间”内任意位置的二维码。
确保手机和PC可以相互PING通

ADsafe是个很好用的去广告软件，但是会阻止本机IP访问，可能造成项目首页打不开，所以请先暂时关闭
本程序会自动获取本机IP，如果有虚拟网卡，IP地址可能获取不正确

客户端（浏览器）

1. 手机浏览器端

一个物体在空间内的旋转体位，都可以用一个方向向量（x,y,z）和旋转角度（angle）来表示。也就是CSS3transform的rotate3d(x,y,z,angle)这个函数的4个参数。

想要在浏览器里方便的绘制一个立体模型的的旋转，重点就是利用手机浏览器的H5新特性去获取手机旋转状态的数据，然后转化成这4个参数。

1.1 重力感应API

devicemotion 顾名思义设备运动。其实不仅仅有重力感应的数据，还有移动加速度，摆动角度。

不过这个接口倾向于运动时瞬间的数据展示，静止时，除了重力加速度，其他数据（移动加速度，摆动角度）基本为0。

window.addEventListener('devicemotion', deviceMotionHandler, true);
function deviceMotionHandler(evt){
   if(evt.accelerationIncludingGravity){
       document.body.innerHTML = 
          "x轴加速度: " + evt.accelerationIncludingGravity.x + "
"
        + "y轴加速度: " + evt.accelerationIncludingGravity.y + "
"
        + "z轴加速度: " + evt.accelerationIncludingGravity.z + "
"
    }
    if(evt.rotationRate ){
       document.body.innerHTML +=  
         "x轴扭转: " + evt.rotationRate.beta + "
" 
       + "y轴扭转: " + evt.rotationRate.gamma + "
"
       + "z轴扭转: " + evt.rotationRate.alpha + "
"
    }
}

（魅族老机型，安卓4.4.4的自带浏览器对此API支持不完全，请另外安装QQ浏览器）

在手机浏览器里运行以上代码，并稍微晃动，会看到打印数据狂跳。拿到了数据，接下来开始观察规律。

手机屏幕朝上，水平静止放置，Z轴重力加速度为9.8，Y,X为0。
手机屏幕朝下，水平静止放置，Z轴重力加速度为-9.8，Y,X为0。
手机话筒朝下，竖直静止放置，Y重力加速度为9.8, X,Z为0。
手机话筒朝上，竖直静止放置，Y重力加速度为-9.8, X,Z为0。
手机右侧朝上，竖直静止放置，X重力加速度为9.8, Y,Z为0。
手机左侧朝下，竖直静止放置，X重力加速度为-9.8, Y,Z为0。

那么手机的空间坐标如下图：

箭头指向都是坐标正方向。

当手机开始倾斜，X,Y,Z轴的加速度分量都有值，且绝对值都小于9.8。根据分量的数值，是可以算出手机在三维空间的倾斜状态，只不过这个计算过程复杂，而且在手机运动时，重力加速度的值并不准确表达当前倾斜。一般不用这个数据去计算手机在三维空间的倾斜。

当手机水平放置，拨动手机，使其慢慢旋转，重力加速度的数据并没有变化。所以，重力感应的这个API，只能获取设备当前的倾斜状态，而无法获取设备的旋转方向。而一些简单的功能，比如摇一摇，晃一晃，就可以用这个接口去实现。

利用重力感应的API，可以轻松利用高中数学的反三角函数，实现XY二维平面的旋转，效果如下：

代码如下：

function deviceMotionHandler(evt){
    var angle = 
    Math.atan2(
            0 - evt.accelerationIncludingGravity.x ,     　　　
            evt.accelerationIncludingGravity.y
        ).toFixed(2) / Math.PI * 180 ; 
}

这个 angle 就可以直接应用在DOM的CSS属性transform:rotate(angle deg)上。

1.2 罗盘API

window.addEventListener('deviceorientation', deviceOrientationHandler, true);
function deviceMotionHandler(evt){
     document.body.innerHTML = 
          "z轴旋转(罗盘方向) alpha: 　" + event.alpha + "
"
        + "y轴旋转 gamma: 　" + event.gamma + "
"
        + "x轴旋转 beta: 　" + event.beta

}

重点来了，deviceorientation能够很好的表现物体在空间中的状态，旋转方向，倾斜角度，无论是静止还是运动或者加速运动。

这里要和devicemotion 的 evt.rotationRate区分一下，虽然都有alpha，gamma，beta 但是 devicemotion 描述的是旋转变化了的角度值，物体角度变化才会有数据，静止了之后就变为0，而 deviceorientation 的是描述是静止时的角度值。

这三个数值的单位都是deg，如何转化为CSS3 transform:rotate3d(x,y,z,angle) 的4个参数，对于没有任何3D知识的前端狗来说是个挺麻烦的问题。

现在要引入一个概念：四元数

四元数是个高阶复数 q = [w,x,y,z]。
四元数的基本数学方程为 :
q = cos (a/2) + i(x * sin(a/2)) + j(y * sin(a/2)) + k(z * sin(a/2)) 其中a表示旋转角度，(x,y,z)表示旋转轴。
四元数表示一个完整的旋转。
四元数可以由各轴旋转角(alpha,beta,gamma)求得。
四元数可以转换旋转轴(x,y,z)和旋转角度(angle)。

作为初试，本篇并不深入讨论四元数的具体定义，难点是获取四元数[w,x,y,z]。好在官方提供了旋转角(alpha,beta,gamma)转换成四元数的方法 https://w3c.github.io/deviceorientation/spec-source-orientation.html

在这个页面内搜索 getQuaternion。

另外我根据数学公式反求，写了一个四元数转(x,y,z,angle) 的函数 getAcQuaternion。代码如下：

var degtorad = Math.PI / 180;
function getQuaternion( alpha, beta, gamma ) {  //官方求四元数方法

  var _x = beta  ? beta  * degtorad : 0; // beta value
  var _y = gamma ? gamma * degtorad : 0; // gamma value
  var _z = alpha ? alpha * degtorad : 0; // alpha value

  var cX = Math.cos( _x/2 );
  var cY = Math.cos( _y/2 );
  var cZ = Math.cos( _z/2 );
  var sX = Math.sin( _x/2 );
  var sY = Math.sin( _y/2 );
  var sZ = Math.sin( _z/2 );

  var w = cX * cY * cZ - sX * sY * sZ;
  var x = sX * cY * cZ - cX * sY * sZ;
  var y = cX * sY * cZ + sX * cY * sZ;
  var z = cX * cY * sZ + sX * sY * cZ;

  return [ w, x, y, z ];

}

function getAcQuaternion( _w, _x, _y, _z ) {  //我的四元数转旋转轴和旋转角度方法

  var rotate = 2 * Math.acos(_w)/degtorad ;

  var x = _x / Math.sin(degtorad * rotate/2) || 0;
  var y = _y / Math.sin(degtorad * rotate/2) || 0;
  var z = _z / Math.sin(degtorad * rotate/2) || 0;

  return {x:x,y:y,z:z,rotate:rotate};

}

function deviceMotionHandler(evt){  // deviceorientation 事件处理函数
  var qu = getQuaternion(evt.alpha,evt.beta,evt.gamma);
  var rotate3d = getAcQuaternion(qu[0],qu[1],qu[2],qu[3]);
  // rotate3d的参数已经有了，随你处理咯。我是把他送给服务器，交给PC，在PC上显示旋转
}

1.3 校准

这里有个3D里的概念，摄像机位置。我们的PC显示器就是一个摄像机。只能被动的从某一个角度展示拍摄的景象。正常情况下，手机所在平面应该和显示器所在平面平行，且垂直于地平面的角度。就好比是，摄像机正对着手机正面拍摄。
如果校准的时候手机并没有垂直于地平面，摄像机的位置就不一定是正前方了。这时候展示的画面并不是水平同步的了。
如下图所示，校准时，手机屏幕朝上。这时候摄像机位置就在天花板上了，你看到的成像就是俯视图。

同理，校准时，手机屏幕朝下，这时候摄像机的位置就是在地上，往上拍摄，你看到的成像就是仰视图。

总结起来就是：校准时，手机屏幕朝着哪里，摄像机就在那里拍摄着屏幕，一动不动。

1.4 兼容性

demo的兼容性测试并不理想，在iOS平台上测试良好，且流畅。

在安卓平台上，除了chrome浏览器之外的浏览器，会出现各种问题，主要表现在罗盘数据不准确。
而chrome浏览器并没有扫一扫功能，因为在国外并不流行这个玩意。所以在安卓平台上就很蛋疼，还要多装一个我查查，才能完整体验。

（如果出现旋转不准确的问题，可以尝试校准罗盘，大概就是拿着手机画8。百度一下方法有很多）

代码如果有兼容写法，或者有其他兼容问题请赐教，可以在coding上私信我(OverTree)，不胜感激。

2. PC浏览器端

PC浏览器的作用就是能够显示房间信息，创建房间。

显示房间，创建时间，参与人数，点击进入。创建一个房间，成功后自动进入房间。

在房间内，接受服务器转发的手机端的消息，并作出相应动作，包括上线，校准，旋转，下线。

上线时，安排就坐（隐藏二维码，显示模型）
校准时，重新设置模型的显示角度
旋转时，就旋转咯
下线时，重新显示二维码（显示二维码，隐藏模型）

2.1初始化，建立ws连接

重点是房间里的事情。所以这里就只介绍进入房间发生的事吧。

首先房间参数要正确，至少有房间编号。

房间路由：/room/[roomNumber] roomNumber是一串16位随机字符串。
座位路由：/room/[roomNumber]/[seatNumber]

var uri = win.location.pathname.split('/'),roomNumber;

function initUrlData(){
  if(uri.length>=3 && uri[1] == "room"){
    roomNumber = uri[2];
    document.title = "虚拟房间 "+ roomNumber + "号"
    return 1;
  }else{
    window.location.href = "/index";
    return 0;
  }
}

function initWebSocket(){
   var wsUri = "ws://"+ window.location.hostname +":<%= config.wsport="" %="">"+"/ws/room"; //这里用了一个ejs的占位符，已便在服务器更改websocket端口时可以及时使用正确端口。
   
   var websocket = new WebSocket(wsUri); 
   websocket.onopen = function(evt) { 
       websocket.send(JSON.stringify({room:roomNumber})); 
   }; //链接建立后，发送一个消息，表明在哪个房间

   websocket.onclose = function(evt) { 

   }; 

   websocket.onmessage = function(evt) { 
       parseMessage(evt.data) //解析数据
   }; 
   websocket.onerror = function(evt) { 

   }; 
   //绑定了这些处理函数之后，websocket开始建立链接，而不是 New 的时候开始建立
}


$(".room-place .qrcode").each(function(index,item){
    $(item).qrcode({
        "size": 200,
        "color": "#3a3",
        "text": window.location.origin + "/room/" + roomNumber + "/" + (index+1)
    });
    //这里用jQuery的插件，jquery-qrcode 按照座位路由初始化二维码
})

2.2 纯CSS3立体模型

做为一名普通的前端人员，想要画一个3D的模型，按照最熟悉的方法就是用CSS3了。（如果是用Three.js的大神请跳过本节）

不过要很快画出一个六面体出来，还是需要想一想的，毕竟这个技能很少用。

画一个长方体

对这样的css有什么要吐槽的么？

这样的stylesheet简直是刀耕火种时期的

如果用sass写法，那么只需要写一次#box和多层嵌套就可以了。

效果如下：

如果我们使用webGL去绘制的话，导入一些现成的3D模型，无论物体还是人物，都可以360度无死角的玩弄于手掌了。
（如果有苍老师的模型，想想还有点小激动呢，VR的感觉说来就来啊 - -）

接下来就是等待来自手机端的旋转信息，x,y,z,angle，使#box进行transform旋转就是了。

$seat.find("#box").
css("transform","rotate3d("
+ (-parseFloat(content.x))+","  //取反
+ (+parseFloat(content.y))+","
+ (-parseFloat(content.z))+","  //取反
+ content.rotate +"deg)");

不取反的话，旋转是错误的。我曾多次尝试给不同的坐标取反，最终得出这个取反方法，是唯一显示正常的组合。

无法理解这两个取反，猜测是因为css的x,y,z的坐标和物理设备x,y,z的坐标方向有差异吧。毕竟显示器是平面的，他的x,y,z的定义不能和手机传感器一致。

2.3 校准

PC端的校准就简单多了，在#box外套一层div.adjust。
当接受来自手机端的校准信息 x,y,z,angle，设置外套的 div.adjust 的旋转为 x,y,z,-angle 就好了。

$seat.find(".adjust").
css("transform","rotate3d("
+ (-parseFloat(content.x))+","  
+ (+parseFloat(content.y))+","
+ (-parseFloat(content.z))+","  
+ (-parseFloat(content.rotate)) +"deg)");  //取反

当然，这个adjust的样式至少包含以下样式

.adjust{
  position: absolute;
  transform-style:preserve-3d;
}

2.4 兼容性

PC端的兼容性就好多了，只要是现代H5浏览器基本上没有兼容性问题。

服务端

1. 数据结构

这个服务只做临时数据的保存和消息转发。
临时数据：比如，各端的webSocket连接句柄，房间信息等，我把它们放在global全局对象下，就好比是共享内存，访问方便，速度快。

global.ShareMem = {
  rooms:{
       "12345678":{          //房间号做为key，方便查找
         player:[{socket:connection,place:place}],          //手机端数组：连接句柄，座位号
         projector:[],       //PC端数组
         id:"12345678",
         startTime:Date.now(),
         maxplayer:2,        //最多座位数
         type:"ddd"          //房间类型
       }
  }
};

2. webServer

如果您是nodejs的大神，或者在用koajs、express等nodejs框架，请跳过本大节。因为我用原生的nodejs写了一遍webServer，虽然重复造轮子不好，但是复习复习webServer的基本知识，还是不错的，本节适合新手入门。
包含知识点：header解析，静态文件查找，gzip，文件hash计算，状态码。

2.1 目录结构

/API
    /funMap.js            /*http功能函数集合*/
    /xxx.js
/socketAPI
    /funMap.js          /*webSocket功能函数集合*/
    /xxx.js
/Util                    /*工具目录，获取本地IP，打开默认浏览器*/
/webRoot
    /common             /*公共资源目录*/
        /js
            /lib
        /css
    /m                  /*移动端html,js,css等*/
    /p                  /*PC端html,js,css等*/
/index.js                  /*入口文件*/
/config.js                /*配置文件，端口号，ws最大数据包大小等*/
/socketServer.js        /*webSocket处理函数*/
/webServer.js

2.2 webServer

基本规则是这样的，搭建静态服务器，静态资源正常读取返回，html文件用ejs渲染后返回。

由于ejs的原因，html文件并没有被修改，但是渲染后的内容被修改，比如，更改了ws的端口，但是html文件没有修改。所以不能使用Last-Modified来判断是文件是否最新，而是要根据返回内容有没有被改变来判断，所以要用Etag。

Etag需要根据内容算出hash值，一般用md5计算。

返回内容之前，需要进行gzip压缩，用来节省带宽。90KB的jquery.min.js可以被gzip到30KB，压缩才是王道。

因为手机端和PC端执行的是完全不同的代码，所以要判断从客户端传过来的user-agent是否包含Mobile字符串，以来区分客户端是PC还是手机，以便返回正确的资源。

通过简单的约定，来区分静态文件和REST请求

    if (libPath.extname(pathName) == "") {
      //如果路径没有扩展名 
      if(params.length<=2){ pathname="" +="/" ;="" 访问根目录="" }else="" if(params[1]="="api"){" 访问以api开头="" parseapi(params,req,res);="" 功能函数="" return="" }else{="" }="" }<="" code="">

我在这里做了一个简单的框架，在API目录或者socketAPI目录下新增js文件，一个js文件对应一个处理函数，然后在funMap.js中聚合为一个Map，方便查找函数，也容易隔离和修改函数名。

var funMap = {
  "room":require("./room"),
  "changeName":require("./xxx"),
  "changeName2":require("./xxxyyy")
};
module.exports = funMap;

客户端访问时就可以通过 /api/[functionName] 来访问想要的服务了。

3. webSocketServer

nodejs本身并没有提供webSockerServer的模块，所以需要另外安装一个。

在npm install的时候会安装一个ws模块，require("ws") 就可以用了。用法与http模块相似，都用 createServer({options},MainHandlerFunction) 创建服务，只是ws多了几个参数。

主要是port，注意不要和webserver端口重复。还有一个 maxPayload 就是单个ws数据包最大大小，单位是bytes，自己估计项目传输数据时候数据包大小。默认值是65535 即 64KB。一般webSocket用于小包传输，不用太大，我设置了1024 , 1KB。

主处理函数MainHandlerFunction，在有客户端连接进来时会传入一个参数connection,这个对象内容非常丰富，不看手册，可以打印出来也慢慢研究。成功建立连接的方法就是要connection绑定message方法。

由于wsSocket访问是可以带着url的，所以我们可以用url隔离不同的功能函数，而不是去解析message主体。

var connectHandler = function(connection){
  // :4002/api/Function1 
  var URIarray = connection.upgradeReq.url.split("/")
  if(funMap[URIarray[2]]){
    funMap[URIarray[2]](connection);
  }else{
    connection.send("{err:Function Not Found!!}");
  }
}

3.1 消息，广播，保活

每当有ws连接进来，都有类似文件描述符的id来区分每个不同的连接。connection._ultron.id 用它可以区分自己与别人的连接，很有用。

//消息格式
function msgPack(){
  return JSON.stringify({
    "who":arguments[0],      // Mobile , PC
    "place":arguments[1],    // 座位
    "dowhat":arguments[2],   // "connect","ready","message","lost"
    "content":arguments[3]||"" // 内容
  })
} 

//以room为单位广播，广播房间内所有角色
function boradCast(room,msg,ignore){
  room.projector.forEach(function(item,index){
    if(ignore&&ignore._ultron.id===item.socket._ultron.id){
      // console.log("ignore!!!")
      // 忽略自己不发送给自己
    }
    else{
      try{
        item.socket.send(msg);
      }catch(e){
        console.log(e);
      }
    }
  });
  room.player.forEach(function(item,index){
    if(ignore&&ignore._ultron.id===item.socket._ultron.id){
      // console.log("ignore!!!")
      // 忽略自己不发送给自己
    }
    else{
      try{
        item.socket.send(msg);
      }catch(e){
        console.log(e);
      }
    }
  });
}

为了检查客户端是否掉线，在建立连接时手动加入保活机制，方法很简单：

给客户端发送空消息时lastkeeplife为1，只要客户端返回任意消息，那么更新lastkeeplife为0，如果5秒之内，没有任何回复判定为掉线。如果客户端掉线，那么关闭连接，从连接池中移除。并广播掉线消息给房间内其他角色。

  var keeplifeHandler = setInterval(function(){
    if(lastkeeplife == 0){
      connection.close();
      connection.emit("close");
      clearInterval(keeplifeHandler);
    }
    try{
      lastkeeplife = 0;
      connection.send("{}");
    }catch(e){
      console.log("keep live error! "+ e +"\n\n");
      connection.close();
      connection.emit("close");
      clearInterval(keeplifeHandler);
    }
  },5000)

  connection.on('close',function(msg){
      if(keeplifeHandler){  //关闭保活循环
        clearInterval(keeplifeHandler);
      }
      console.log("close!",roomid,place);
      var room = global.ShareMem.rooms[roomid];
      if(!room)
        return;
      
      //从连接池移除连接句柄
      if(platform === PC){
          room.projector.forEach(function(item,index){
              if(item.socket === connection){
                  room.projector.splice(index,1);
                  return false;
              }
          })
      }else{
          room.player.forEach(function(item,index){
              if(item.socket === connection){
                  room.player.splice(index,1);
                  return false;
              }
          })
      }
      //发送掉线消息
      boradCast( room, msgPack(platform,place,"lost") , connection );
  });

iOS设备如果锁屏，会发送断开信息给服务器，而安卓不会。想要断开链接，必须等到默认120秒超时后关闭。
ws初始化时并没有提供初始化timeout的配置。通过修改ws._server.timeout = 1000;//1秒超时 并不会生效。问题来了，怎么修改才能设置超时时间呢？

目前只能用上述比较捉急的方法来及时断开掉线设备。

最后

多屏互动已经不是新鲜的东西了，我做这个Demo还是受chrome实验室一个叫做【光剑出鞘】的项目的启发。因为体验时需要手机端和PC同时翻-墙，导致体验差，然后自己才想做一个。做出来的时候感觉好酷炫，好神奇，好兴奋。

后续还是有很多可以拓展和改进的，希望最终可以变为一个成熟的产品，而不是仅仅止步于Demo。

相关阅读

作者信息
作者来自力谱宿云 LeapCloud 团队_UX成员：王诗诗【原创】
首发地址：https://blog.maxleap.cn/archives/985

王诗诗，前端新人，专职前端工作两年。曾供职于AMI做底层软件开发。喜欢分析H5代码，追崇用简单的CSS，构建精美动效，做前端之前，这些是业余爱好。现任职于MaxLeap UX 组，负责MaxWon 的开发和维护。现热衷于Real-time WebApp。

欢迎关注微信订阅号：从移动到云端