os 系统

使用该类让渲染引擎初始化以及一些常用的函数（如发布后的窗口操作）

维护人员：黑暗之神KDS
创建时间：2017-01-16

继承 无
子类 无

Public 属性

Public 方法

详情

canvas

canvas : HTMLCanvasElement;

[静态]只读获取canvas元素对象
必须在os初始化后才能够获得

platform

platform : number;

[静态]只读获取所在平台
 0-GameCreator Web GC-网站平台
 1-GameCreator App GC-APP
 2-PC 电脑端
 3-Web/Mobile phone Web 普通网页端（包括移动版）
@return

init

init(stageWidth? : number, stageHeight? : number, isWebGL? : boolean, is3D? : boolean): void :

静态系统初始化

参数

[可选]stageWidth 舞台宽 默认是页面大小 默认值=0
[可选]stageHeight 舞台高 默认是页面大小 默认值=0,@isWebGL [可选]是否webgl模式，默认true
@is3D [可选]是否3D模式 目前暂未支持

add_ENTERFRAME

add_ENTERFRAME(onHappen : Function, thisPtr : any, args? : any): void :

静态添加帧循环，让函数逐帧执行（帧刷）

var i =0;
os.add_ENTERFRAME(() => {
  trace(++i);
}, this);

参数

onHappen onHappen(arg1,arg2,...)
thisPtr 作用域
args [可选]参数集合 默认值=null

remove_ENTERFRAME

remove_ENTERFRAME(onHappen : Function, thisPtr : any): void :

静态移除帧循环
比如添加帧刷后一定概率移除掉帧刷

function gameUpdate(){
   if(Math.random()<0.2){
      os.remove_ENTERFRAME(gameUpdate, this);
   }
}
os.add_ENTERFRAME(gameUpdate, this);

参数

onHappen 利用add_ENTERFRAME注册的回调方法
thisPtr 作用域

setCursor

setCursor(style : string): void :

静态当前鼠标样式 如 os.setCursor("wait");
比如游戏中需要更换鼠标样式可以使用该方法更换，支持自定义的图片和.cur格式光标文件（cur格式支持偏移中心点）
url 自定义图片 如 os.setCursor("url('icon.png'),pointer"); os.setCursor("url('icon.png'),default");
default 默认光标（通常是一个箭头）
auto 默认。浏览器设置的光标。
crosshair 光标呈现为十字线。
pointer 光标呈现为指示链接的指针（一只手）
move 此光标指示某对象可被移动。
e-resize 此光标指示矩形框的边缘可被向右（东）移动。
ne-resize 此光标指示矩形框的边缘可被向上及向右移动（北/东）。
nw-resize 此光标指示矩形框的边缘可被向上及向左移动（北/西）。
n-resize 此光标指示矩形框的边缘可被向上（北）移动。
se-resize 此光标指示矩形框的边缘可被向下及向右移动（南/东）。
sw-resize 此光标指示矩形框的边缘可被向下及向左移动（南/西）。
s-resize 此光标指示矩形框的边缘可被向下移动（南）。
w-resize 此光标指示矩形框的边缘可被向左移动（西）。
text 此光标指示文本。
wait 此光标指示程序正忙（通常是一只表或沙漏）。
help 此光标指示可用的帮助（通常是一个问号或一个气球）。

restoreCursor

restoreCursor(): void :

静态恢复更改前的记录光标

detectOS

detectOS(): string :

静态获取操作系统

返回

Mac/Unix/Linux/Win2000/WinXP/Win2003/WinVista/Win7/Win10/Android/iPhone/other

resizeTo

resizeTo(width : number, height : number): void :

静态【仅PC端】设置窗口尺寸（单位：像素），发布后支持

参数

width 宽度
height 高度

moveTo

moveTo(x : number, y : number): void :

静态【仅PC端】设置窗口位置（单位：像素），发布后支持

参数

x 水平坐标
y 垂直坐标

setResizable

setResizable(resizable : boolean): void :

静态【仅PC端】设置是否允许更改窗口尺寸，发布后支持

参数

resizable 是否允许

setAlwaysOnTop

setAlwaysOnTop(alwaysOnTop : boolean): void :

静态【仅PC端】设置是否允许窗口显示在最前方，发布后支持

参数

alwaysOnTop 是否允许

maximize

maximize(): void :

静态【仅PC端】最大化窗口，发布后支持

minimize

minimize(): void :

静态【仅PC端和Android端】最小化窗口，发布后支持

restore

restore(): void :

静态【仅PC端】还原窗口（用于最大化或最小化后调用可还原），发布后支持

closeWindow

closeWindow(): void :

静态【仅PC端和Android端】关闭当前窗口，在编辑器中也可以关闭

inGC

inGC(): boolean :

静态是否在GC环境中

showFPS

showFPS(): void :

静态显示FPS，必须在引擎初始化之后才生效

hideFPS

hideFPS(): void :

静态隐藏FPS，必须在引擎初始化之后才生效

shake

shake(time : number | number): voi :

静态设备震动（目前仅支持安卓设备）

参数

time (number | number[]) number类型表示震动持续时间 number[]类型表示自定义交替的震动、暂停、震动