Skip to content

ShareQiu1994/CesiumRoleController

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌎 一款基于Cesium的三维角色控制器插件

Npm version Npm downloads GitHub stars License

演示地址

http://devmodels.oss-cn-shenzhen.aliyuncs.com/devtest/liubofang/CesiumRoleController/index.html

下载运行此示例代码

   yarn install  // 安装依赖
   yarn run serve  // 运行示例代码
   yarn run build  // 编译打包示例代码

快速上手

import CesiumRoleController from 'cesium-role-controller'

/*
import * as Cesium from 'cesium'
let viewer = Cesium.viewer({...})
*/

let controller = new CesiumRoleController(Cesium, viewer)
controller.init({
  position: [106.306177, 36.030691],
  url: 'http://devmodels.oss-cn-shenzhen.aliyuncs.com/devtest/liubofang/glb/foreigner_cesium.glb',
  animation: 'run',
})

API 文档

options

名称 说明 类型 可选值 默认值 是否必选
url 模型地址 string - -
position 初始经纬度坐标 array - -
animation 模型动画名称 string - -
speed 运动速度 number - 1
pitch 相机看向模型的俯仰角度 number 0~-90 -25
lockViewLevel 相机看向模型的限制级别,等级由低到高,1 为自由视角,3 为全限制 number 1~3 3
range 相机看向模型的视角范围 number 0~99999 4

method

名称 说明 参数 参数类型 返回值 使用方法
init 初始化 options object void controller.init({...})
destroy 销毁 - - void controller.destroy()

注意事项

  1. 本插件基于 Cesium 104+以上版本进行开发,如需兼容早期版本,可自行修改源码
  2. 通过键盘 W/S/A/D 控制人物移动和鼠标控制相机视角
  3. 当在启用地形的地图下时 可以把 speed 和 range 设置大一些 如 speed:10 range:1000

版权说明

  1. cesium-role-controller 插件由liubf自主研发,拥有所有权利。
  2. 任何个人或组织可以在遵守相关要求下可以免费无限制使用。

版本日志

1.0.0 2023/06/07

  1. 添加初始化配置参数
  2. 添加初始化方法

1.0.1 2023/06/08

  1. 修复配置文件参数拼写错误 参数 lookViewLevel 修改为 lockViewLevel

1.0.2 2023/06/08

  1. 修复自由视角下相机飘的问题

1.0.3 2023/06/08

  1. 修复自由视角下多个按键按下相机飘的问题

1.0.4 2023/06/09

  1. 优化一些局部问题

示例视频

贴合地形视频

贴合 3dtiles 视频

About

一款基于Cesium的三维角色控制器插件

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published