# OmniSight Android 用户使用说明

> 当前 Android 版本需要 root / su 权限。免 root 分身框架版本后续单独提供。

## 需要的文件

把下面 5 个文件放到手机 `/data/local/tmp/`：

```text
libomnisight_android.so
omnisight_ptrace_loader
inject_omnisight.sh
omnisight_android.cfg
set_omnisight_input_mode.sh
```


## 注入使用

1. 先打开游戏，进入大厅或对局。
2. 执行：

```sh
su -c sh /data/local/tmp/inject_omnisight.sh
```

3. 成功后游戏内会显示 OmniSight 界面。
4. 第一次使用需要输入卡密登录。

## 常用输入模式

默认不用改。如果界面显示了但无法触摸，执行：

```sh
su -c "sh /data/local/tmp/set_omnisight_input_mode.sh consume"
```

然后重启游戏，再重新注入。

如果需要恢复默认：

```sh
su -c "sh /data/local/tmp/set_omnisight_input_mode.sh auto"
```

## 卸载 / 重新注入

优先在 OmniSight 菜单里点击 `Uninstall`。

如果已经无法操作菜单，直接重启游戏，再重新执行注入命令。

## 日志位置

如果没有显示 UI、闪退、无法触摸，把日志文件发出来：

```text
/sdcard/Download/omnisight_android.log
/data/local/tmp/omnisight_android.log
```

一般优先发 `/sdcard/Download/omnisight_android.log`。

## 常见问题

`没有 UI`

先确认已经进入游戏并执行了注入命令。如果仍然没有，查看日志里是否有 `overlay initialized`、`data bridge ready`。

`界面能显示但不能触摸`

切换输入模式：

```sh
su -c "sh /data/local/tmp/set_omnisight_input_mode.sh consume"
```

`重新注入后闪退`

先重启游戏，再注入。正常情况下不要连续反复执行注入命令。

`提示目标没运行`

先手动打开游戏，再执行：

```sh
su -c sh /data/local/tmp/inject_omnisight.sh
```

