Skip to content

Latest commit

 

History

History
68 lines (39 loc) · 2.29 KB

自定义虚拟按键.md

File metadata and controls

68 lines (39 loc) · 2.29 KB
Raw

English document

自定义虚拟按键

功能介绍

本文档主要介绍如何为您的游戏添加虚拟按键。

您接入之后SDK可以通过加载配置文件动态生成自定义的虚拟按键。

framework组件说明：

TCRVKey.framework，虚拟按键拓展库。

接口介绍

接口名称 接口描述
TCRVKeyGamepad initWithFrame:(CGRect)frame session:(TcrSession *)session; 创建虚拟按键的视图
TCRVKeyGamepad showKeyGamepad:(NSString *)cfg; 加载虚拟按键布局，生成按键
TCRVKeyGamepad needConnected() 启用当前的按键布局是否需要主动通知云端

调用示例

- (void)initControlViews {
    self.gamepad = [[TCRVKeyGamepad alloc] initWithFrame:self.view.bounds session:self.session];
    [self.view addSubview:self.gamepad];
    [self.gamepad showKeyGamepad:[self readJsonFromFile:@"tcg_default_ps4"]];
}

接入后功能使用

支持的按键

支持的按键主要分为三类，鼠标及摇杆、键盘、手柄。

鼠标及键盘十字键

1、鼠标按键（左、中、右、上滚、下滚）

2、键盘十字键（上下左右、WASD） 将W、A、S、D四个常规键盘按键合成一个类似游戏手柄的十字方向键，按压正上方时触发'W'按键消息，按45度角同时触发相邻两个按键。 上下左右十字键触发按键消息类同。

键盘

1、实体键盘中常用的78个点击类按键

手柄

1、左、右摇杆键

2、手柄十字键

3、普通点击按键（A、B、X、Y、△、☐、×、○、Select、Start、LB、RB、L3、R3）

4、延时扳机键（LT、RT）【点击时在短时间内连续发多次消息，消息的力度随时间逐增减】

配置文件生成

我们还提供了键盘布局文件生成工具(https://github.com/tencentyun/cloudgame-android-sdk/tree/master/TcrSdk/Tools)，您可以使用该工具生成的按键布局配置供SDK使用。

注：您不需要关心配置文件中的内容以及生成规则，您只需要导入和保存生成的配置文件供游戏使用。