点击这里申请百度智能云特邀VIP帐号，立即体验AR开放平台>>>

百度智能云AR开放平台使用指南-AR场景开发专题游戏摇杆

游戏摇杆

游戏摇杆是互动常用控件之一，用于移动端角色、模型控制。配置一个游戏摇杆需要对应贴图素材（外环和内环）和确定所处屏幕位置，json中配置游戏素材相关，lua脚本中实现摇杆动作回调和游戏逻辑。

Sample case ：代码下载

json配置方法如下（//后为注释，实际使用请删除）：

//joystick列表
"joysticks": [
    {
    	"name": "joystick1", //joystick名称，用于检索，数据更新
    	"relative": 0,//相对移动，outer是否跟随触碰
    	"responseRegion": {//joystick响应范围
    	"rectangle": {//矩形范围，屏幕百分比范围，含义同hud
       	 	"marginLeftRatio": 0,
        	"marginTopRatio": 0,
       	 	"widthRatio": 0.8,
        	"heightRatio": 0.4
    	}
    },
    //外环实际渲染对象的配置，沿用hud节点配置
    "outer": {
        "name": "outer_hud",
        "type": "plane",
        "visible": 1,
        "touchable": 1,
        "material": {
        "common": {
        "textureList": [
                     {
                     "textureName": "res/texture/outer.jpeg"
                     }
                     ]
        }
        },
        "hudElement": {
            "marginLeft": 0.1,
            "marginTop": 0.07,
            "depthPosition": 0,
            "ratio": {
                "widthRatio" : 0.3,
                "keepAspectRatio":1
            }
        },
        "children": [],
        	//内环实际渲染对象的配置，沿用hud节点配置，hud位置为相对父节点布局
        "inner": {
            "name": "inner_hud",
            "type": "plane",
            "visible": 1,
            "touchable": 1,
            "material": {
            "common": {
            "textureList": [
                         {
                         "textureName": "res/texture/bear3.jpeg"
                         }
                         ]
            }
            },
            "hudElement": {
                "marginTop": 0.25, 
                "marginLeft": 0.25, 
                "depthPosition": 200, 
                "ratio": {
                    "heightRatio" : 0.5,
                    "keepAspectRatio": 1
                }
            } 
    	}
	}
]

游戏摇杆的内外环节点的配置沿用hud节点配置，内环为外环子节点，游戏摇杆可以在json设定为相应区域、相对移动等属性，详情见joystick静态配置文档。

脚本回调配置方法：

local input_controller = scene:get_inut_controller()
local joystick = input_controller:get_joystick_by_name("joystick")
joystick:set_update_handler(joystick_update)
function joystick_update(x,y)
end

回调函数中返回内环的相对移动偏移，根据该偏移控制场景内事件，详情见Joystick接口文档。