1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
| local api -- 控制街口对象表,，通过sf_start事件回调获得,存放在模块局部变量中，详情请查阅（api接口.txt）
local selfIndex -- 自己在桌面的的索引,通过 sf_start 开始游戏事件回调参数获得
local members -- 游戏玩家array数组，通过 sf_start 开始游戏事件回调参数获得
-- 每个玩家拥有 uid, name, position, vip, gold, gender
--- 开始游戏事件回调
-- @function sf_start
-- @tab members 所有玩家数组
-- @int index 自己在桌面的的索引，0是旁观，旁观用户不能操作游戏。
-- @tab nativeapi 控制街口对象表
-- @boolean again 是否是断线后重新加入游戏,true为断线后重新加入游戏，无需播放开始游戏等音效。
local function sf_start(membersArray,index,nativeapi,again)
-- 通常将所需变量保存到模块
members = membersArray -- 保存桌面玩家数组
selfIndex = index -- 保存自己的索引
api = nativeapi -- 保存API对象表
end
--- 游戏结束事件回调,表明这局游戏结束了
-- @function sf_over
local function sf_over()
end
--- 网络数据响应事件回调
-- @function sf_message
-- @tab data 服务器下发的数据表
-- @int index 哪个玩家发送来的信息,0服务器发送
local function sf_message(data,index)
end
--- 键盘按下事件回调
-- @function sf_keydown
-- @int keycode 键盘响应码，请查阅Constants.txt
-- @boolean repeated 是否是重复键，一般案下一个键时，为一次新键，不松手，会一直响应keydown，这个时候repeated为true，表明是重复键。
local function sf_keydown(keycode,repeated)
end
--- 键盘抬起回调
-- @function sf_keyup
-- @int keycode 键盘响应码，请查阅Constants.txt
local sf_keyup = function(keycode)
end
--- 触摸响应事件回调，只能在安卓平台和ios平台以及web平台使用
-- @function sf_touch
-- @int touchtype 手势种类，请查阅Constants
-- @int x x坐标
-- @int y y坐标， 坐标返回的是设计逻辑尺寸，请参考绘图接口中的逻辑坐标dwidth和dheight
-- @int fingers 本次手势的手指数，一般1到3个手指，在多的手指需要硬件支持，有的手机触摸屏支持10个手指，一般到四个手指。
-- @int gid 本次触摸的模式编号，100位全屏触摸编号，200位分屏触摸中的上半屏编号，300位分屏模式下的下半屏幕触摸编号
local function sf_touch(touchtype, x, y,fingers,gid)
end
--- 每一帧调用，用于时时游戏的更新,每一秒60帧
-- @function update
-- @number ds 两次update调用之间的时间差，单位秒，精确到小数点后3位
local function sf_update(ds)
end
--- 游戏控制器响应，包括游戏手柄
-- @function sf_gamecontroller
-- @tab msg 数据响应结构表
-- @int msg.which 表示是哪个控制器或者手柄发出的消息，相当于手柄ID,从0开始，一般电脑支持8个手柄。
-- @int msg.timestamp 消息发出的时间戳
-- @int msg.type 手柄响应码,详情参阅,在api.Constants上的常亮表，目前三种消息，轴变化消息，按键按下，按键抬起消息。
-- @int msg.button 当msg.type是按键按下或者抬起的情况下，表示按钮的编号，详情请参阅：在api.Constants上的常亮表
-- @int msg.axis 当前type是轴消息的时候，他表示是哪个轴发出来的变化消息，如左边摇杆x水平变化，则axis为0，右边摇杆上下变化，则axis为3
-- @int msg.value 表示轴变化的当前状态，范围-32768到32767，摇杆在圆点则为0，否则符号和他所处的轴方向相同。
local function sf_gamecontroller(msg)
end
--- 鼠标响应事件
-- @function sf_mouse
-- @tab msg 数据响应结构表
-- @int msg.type 鼠标事件类型，详情参考常亮表client
-- @int msg.button 鼠标案件类型，详情参考常亮表client
-- @int msg.x msg.y 鼠标逻辑坐标
local function sf_mouse(msg)
end
-- 导出接口方法
return {
start=sf_start,
over=sf_over,
message=sf_message,
keydown=sf_keydown,
keyup=sf_keyup, -- 可选
touch=sf_touch,
update=sf_update,
gamecontroller=sf_gamecontroller,
mouse=sf_mouse,
}
|