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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
local leap = require 'leap'
local mapargs = require 'mapargs'
local LLAgent = {}
function LLAgent.getRegionPosition()
return leap.request('LLAgent', {op = 'getPosition'}).region
end
function LLAgent.getGlobalPosition()
return leap.request('LLAgent', {op = 'getPosition'}).global
end
-- Return array information about the agent's groups
-- id: group id\n"
-- name: group name\n"
-- insignia: group insignia texture id
-- notices: bool indicating if this user accepts notices from this group
-- display: bool indicating if this group is listed in the user's profile
-- contrib: user's land contribution to this group
function LLAgent.getGroups()
return leap.request('LLAgent', {op = 'getGroups'}).groups
end
-- Use LL.leaphelp('LLAgent') and see 'setCameraParams' to get more info about params
-- -- TYPE -- DEFAULT -- RANGE
-- LLAgent.setCamera{ [, camera_pos] -- vector3
-- [, focus_pos] -- vector3
-- [, focus_offset] -- vector3 -- {1,0,0} -- {-10,-10,-10} to {10,10,10}
-- [, distance] -- float (meters) -- 3 -- 0.5 to 50
-- [, focus_threshold] -- float (meters) -- 1 -- 0 to 4
-- [, camera_threshold] -- float (meters) -- 1 -- 0 to 4
-- [, focus_lag] -- float (seconds) -- 0.1 -- 0 to 3
-- [, camera_lag] -- float (seconds) -- 0.1 -- 0 to 3
-- [, camera_pitch] -- float (degrees) -- 0 -- -45 to 80
-- [, behindness_angle] -- float (degrees) -- 10 -- 0 to 180
-- [, behindness_lag] -- float (seconds) -- 0 -- 0 to 3
-- [, camera_locked] -- bool -- false
-- [, focus_locked]} -- bool -- false
function LLAgent.setCamera(...)
local args = mapargs('camera_pos,focus_pos,focus_offset,focus_lag,camera_lag,' ..
'distance,focus_threshold,camera_threshold,camera_pitch,' ..
'camera_locked,focus_locked,behindness_angle,behindness_lag', ...)
args.op = 'setCameraParams'
leap.send('LLAgent', args)
end
function LLAgent.setFollowCamActive(active)
leap.send('LLAgent', {op = 'setFollowCamActive', active = active})
end
function LLAgent.removeCamParams()
leap.send('LLAgent', {op = 'removeCameraParams'})
end
-- Play specified animation by "item_id" locally
-- if "inworld" is specified as true, animation will be played inworld instead
function LLAgent.playAnimation(...)
local args = mapargs('item_id,inworld', ...)
args.op = 'playAnimation'
return leap.request('LLAgent', args)
end
function LLAgent.stopAnimation(item_id)
return leap.request('LLAgent', {op = 'stopAnimation', item_id=item_id})
end
-- Get animation info by "item_id"
-- reply contains "duration", "is_loop", "num_joints", "asset_id", "priority"
function LLAgent.getAnimationInfo(item_id)
return leap.request('LLAgent', {op = 'getAnimationInfo', item_id=item_id}).anim_info
end
-- Teleport to specified "regionname" at specified region-relative "x", "y", "z".
-- If "regionname" is "home", ignore "x", "y", "z" and teleport home.
-- If "regionname" omitted, teleport to GLOBAL coordinates "x", "y", "z".
function LLAgent.teleport(...)
local args = mapargs('regionname,x,y,z', ...)
args.op = 'teleport'
return leap.request('LLTeleportHandler', args).message
end
-- Call with no arguments to sit on the ground.
-- Otherwise specify "obj_uuid" to sit on,
-- or region "position" {x, y, z} where to find closest object to sit on.
-- For example: LLAgent.requestSit{position=LLAgent.getRegionPosition()}
-- Your avatar should be close enough to the object you want to sit on
function LLAgent.requestSit(...)
local args = mapargs('obj_uuid,position', ...)
args.op = 'requestSit'
return leap.request('LLAgent', args)
end
function LLAgent.requestStand()
leap.send('LLAgent', {op = 'requestStand'})
end
-- ***************************************************************************
-- Autopilot
-- ***************************************************************************
LLAgent.autoPilotPump = "LLAutopilot"
-- Start the autopilot to move to "target_global" location using specified parameters
-- LLAgent.startAutoPilot{ target_global array of target global {x, y, z} position
-- [, allow_flying] allow flying during autopilot [default: true]
-- [, stop_distance] target maximum distance from target [default: autopilot guess]
-- [, behavior_name] name of the autopilot behavior [default: (script name)]
-- [, target_rotation] array of [x, y, z, w] quaternion values [default: no target]
-- [, rotation_threshold] target maximum angle from target facing rotation [default: 0.03 radians]
-- an event with "success" flag is sent to "LLAutopilot" event pump, when auto pilot is terminated
function LLAgent.startAutoPilot(...)
local args = mapargs('target_global,allow_flying,stop_distance,behavior_name,target_rotation,rotation_threshold', ...)
args.op = 'startAutoPilot'
leap.send('LLAgent', args)
end
-- Update target location for currently running autopilot
function LLAgent.setAutoPilotTarget(target_global)
leap.send('LLAgent', {op = 'setAutoPilotTarget', target_global=target_global})
end
-- Start the autopilot to move to the specified target location
-- either "leader_id" (uuid of target) or "avatar_name" (avatar full name: use just first name for 'Resident') should be specified
-- "allow_flying" [default: true], "stop_distance" [default: autopilot guess]
function LLAgent.startFollowPilot(...)
local args = mapargs('leader_id,avatar_name,allow_flying,stop_distance', ...)
args.op = 'startFollowPilot'
return leap.request('LLAgent', args)
end
-- Stop the autopilot system: "user_cancel" indicates whether or not to act as though user canceled autopilot [default: false]
function LLAgent.stopAutoPilot(...)
local args = mapargs('user_cancel', ...)
args.op = 'stopAutoPilot'
leap.send('LLAgent', args)
end
-- Get information about current state of the autopilot
function LLAgent.getAutoPilot()
return leap.request('LLAgent', {op = 'getAutoPilot'})
end
return LLAgent
|
