https://github.com/gcssloop/rocker
安卓虚拟摇杆
https://github.com/gcssloop/rocker
Last synced: 9 months ago
JSON representation
安卓虚拟摇杆
- Host: GitHub
- URL: https://github.com/gcssloop/rocker
- Owner: GcsSloop
- License: apache-2.0
- Created: 2015-09-15T05:35:58.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2016-12-18T17:18:59.000Z (almost 9 years ago)
- Last Synced: 2025-03-22T14:22:13.634Z (9 months ago)
- Language: Java
- Size: 2.01 MB
- Stars: 121
- Watchers: 4
- Forks: 33
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
Rocker
[](https://www.apache.org/licenses/LICENSE-2.0)
[](https://jitpack.io/#GcsSloop/Rocker)
一个安卓虚拟摇杆程序，可作为游戏控制器或者小车遥控器。
### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop)
## 摘要
由于需要制作一个控制小车移动的应用，使用按键控制不太舒服，故制作了一个虚拟摇杆。
之前的摇杆程序只是满足了基本功能，还有很多不方便以及不合理的地方，本次对其进行了重构，使其结构更佳合理，也完善了之前不足的部分。
**目前已完成内容:**
* 程序结构更佳合理
* 视图大小自适应
* 支持界面预览
* 支持在界面文件中直接配置参数
* 增加定时发送状态数据
------
* 基于 [hello-earth](https://github.com/hello-earth) 小伙伴的建议，分离了界面刷新周期和数据回调周期。
## 使用示例
### 默认参数
``` xml
```
### 自定义参数
可自定义参数包括:
| 参数类型 | 中文 | 数据类型 | 默认值 | 简介 |
| ----------------- | ---- | ---------------- | ----- | --------------------------------- |
| area_radius | 区域半径 | dimension | 75dp | 摇杆可活动区域的半径 |
| rocker_radius | 摇杆半径 | dimension | 25dp | 摇杆本身半径 |
| area_background | 区域背景 | color, reference | CYAN | 区域背景 |
| rocker_background | 摇杆背景 | color, reference | RED | 摇杆背景 |
| refresh_cycle | 刷新周期 | integer | 30ms | 界面刷新周期，默认30毫秒，每30ms就会刷新一次界面 |
| callback_cycle | 回调周期 | integer | 100ms | 数据回调周期，默认100毫秒，每100ms就会发送一次界面状态回调 |
>
> **视图大小会根据 区域半径以及摇杆半径值自适应，一般使用 wrap_content 即可。**
**请在 layout 文件的根节点添加命名空间: `xmlns:rocker="http://schemas.android.com/apk/res-auto"`**
``` xml
```
### 监听回调
监听回调可监听到两个事件.
| 事件类型 | 中文 | 简介 |
| ------------ | ---- | ------------------------------------ |
| EVENT_ACTION | 操作事件 | 用户点击和滑动时会返回当前角度，当用户手指离开屏幕，返回 -1 |
| EVENT_CLOCK | 时钟事件 | 定时返回当前角度，如果没有任何操作，则返回 -1，默认每30ms返回一次 |
``` java
RockerView rocker = (RockerView) findViewById(R.id.rocker);
if (null != rocker){
rocker.setListener(new RockerView.RockerListener() {
@Override
public void callback(int eventType, int currentAngle, float currentDistance) {
switch (eventType) {
case RockerView.EVENT_ACTION:
// 触摸事件回调
Log.e("EVENT_ACTION-------->", "angle="+currentAngle+" - distance"+currentDistance);
break;
case RockerView.EVENT_CLOCK:
// 定时回调
Log.e("EVENT_CLOCK", "angle="+currentAngle+" - distance"+currentDistance);
break;
}
}
});
}
```
**PS：EVENT_CLOCK 是定时返回当前状态的，可以用 'callback_cycle' 来控制数据回调周期。**
## 如何添加
**Step 1. 添加JitPack仓库**
在当前项目等根目录下的 `build.gradle` 文件中添加如下内容:
``` gradle
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
```
**Step 2. 添加项目依赖**
``` gradle
dependencies {
compile 'com.github.GcsSloop:Rocker:v1.1.1'
}
```
## [:point_right:版本更新记录:point_left:](https://github.com/GcsSloop/Rocker/releases)
## About Me
### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop)
## License
```
Copyright (c) 2016 GcsSloop
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```