You need to enable JavaScript to run this app.
导航
附件
最近更新时间:2025.11.20 10:33:55首次发布时间:2023.06.14 12:45:19
复制全文
我的收藏
有用
有用
无用
无用

开通火山引擎对象存储访问权限

调用 PushFilePullFile 接口之前,需要通过火山引擎控制台 访问控制 页面新建名为 PaasServiceRole 的用户角色,并授予相关访问策略。操作步骤如下:

  1. 登录火山引擎控制台,使用主账号登录火山引擎控制台,点击页面右上角账号头像,在下拉菜单中选择 访问控制,打开 访问控制 页面。

  2. 在左侧导航栏中打开 角色 页面,点击 新建角色,完成以下配置,并点击 下一步

    • 选择信任身份:服务
    • 选择服务:云手机

    Image

  3. 输入角色名 PaasServiceRole,点击 下一步
    Image

  4. 搜索 TOSFullAccessSTSAssumeRoleAccess 权限策略,将其赋予新建的角色,点击 提交
    Image

  5. 完成角色创建和授权。
    Image

System Properties 属性列表

云手机服务支持在创建实例时设置云手机属性、在更新实例属性时对实例属性进行修改。

说明

Android 系统中的可配置属性:

属性(key)

属性值(value)

属性说明

属性填写规范

debug.sensor.xxx.name

例:TestName

修改传感器名称。
xxx 表示传感器类型,目前支持以下 13 类型:
TYPE_ACCELEROMETER = 1(加速度传感器)
TYPE_MAGNETIC_FIELD = 2(磁力传感器)
TYPE_ORIENTATION = 3(方向传感器)
TYPE_GYROSCOPE = 4(陀螺仪传感器)
TYPE_LIGHT = 5(光传感器)
TYPE_PRESSURE = 6(压力传感器)
TYPE_TEMPERATURE = 7(温度传感器)
TYPE_PROXIMITY = 8(近程传感器)
TYPE_GRAVITY = 9(重力传感器)
TYPE_LINEAR_ACCELERATION = 10(线性加速度传感器)
TYPE_ROTATION_VECTOR = 11(旋转矢量传感器)
TYPE_RELATIVE_HUMIDITY = 12(湿度传感器)
TYPE_AMBIENT_TEMPERATURE = 13(环境温度传感器)

String 类型,示例:setprop debug.sensor.1.name "TestName"

debug.sensor.xxx.vendor

例:TestVendor

修改传感器厂商。
xxx 表示传感器类型,目前支持以下 13 类型:
TYPE_ACCELEROMETER = 1(加速度传感器)
TYPE_MAGNETIC_FIELD = 2(磁力传感器)
TYPE_ORIENTATION = 3(方向传感器)
TYPE_GYROSCOPE = 4(陀螺仪传感器)
TYPE_LIGHT = 5(光传感器)
TYPE_PRESSURE = 6(压力传感器)
TYPE_TEMPERATURE = 7(温度传感器)
TYPE_PROXIMITY = 8(近程传感器)
TYPE_GRAVITY = 9(重力传感器)
TYPE_LINEAR_ACCELERATION = 10(线性加速度传感器)
TYPE_ROTATION_VECTOR = 11(旋转矢量传感器)
TYPE_RELATIVE_HUMIDITY = 12(湿度传感器)
TYPE_AMBIENT_TEMPERATURE = 13(环境温度传感器)

String 类型,示例:setprop debug.sensor.1.vendor "TestVendor"

gsm.version.baseband

例:1.0.0.0

基带版本

keep_alive_whitelist

例:com.example1,com.example2

开机自启动和保活的应用包名(只能通过持久化参数设置)

多个应用包名用分号隔开;单个属性值的长度不可超过91个字符

persist.sys.locale

例:en-US/zh-CN

地区

persist.sys.bd.grant_perm_install

例:true/false

是否允许应用安装后自动获取到所有权限
true:(默认值)允许
false:禁止

persist.sys.bd.proc_state_broadcast

例:true/false

开关应用启动、结束进程的广播
true:开启
false:(默认值)关闭

persist.sys.bd.unknowsource_verify

例:true/false

开关在 PackageInstaller 中处理未知应用来源时的弹框告警
true:(默认值)开启
false:关闭

persist.sys.dsp.enable

例:1/0

是否开启 DSP 功能
true:开启
false:(默认值)关闭

persist.sys.allow_capture_secure

例:true/false

开关云手机画面截图的安全限制
true:允许对开启安全保护的页面进行截图
false:(默认值)不允许对登录页等开启安全保护的页面进行截图

persist.sys.native_ime

例:true/false

是否调用本地输入法或云机实例输入法:

  • true(默认值):
    • 当客户端 SDK enableLocalKeyboard 接口也设置为 true 时,调用客户端本地输入法
    • 当客户端 SDK enableLocalKeyboard 接口设置为 false 时,调用云机实例输入法
  • false:无论客户端 SDK enableLocalKeyboard 接口设置为 truefalse,默认调用云机实例输入法

persist.sys.scroll_friction

例: 1.0

设置实例屏幕滚动摩擦力,可用于控制屏幕的滑动惯性效果。

  • 设置为 1.0:完全消除滑动惯性。当自动化脚本的滑动指令结束(或模拟手指抬起)时,屏幕滚动会立即停止
  • 设置为 0.15:安卓系统默认的、流畅自然的滑动惯性效果。手指快速滑动后,内容会继续平滑滚动一段距离,与在实体手机上的体验一致。

说明

该属性仅 AOSP 13 支持设置。

persist.sys.sendevent.enable

例:true/false

是否开启触控事件注入
true:开启;支持的 input 节点为 ByteInputDevice,详细说明参考 附件
false:关闭

persist.sys.bd.capture_permission

例:true/false

抓屏(如截屏、录屏)时是否屏蔽敏感信息获取权限申请弹窗。
true:是,即抓屏时不弹窗;
false:(默认值)否,即抓屏时弹窗提醒。

ro.product.manufacturer

例:HW

厂商

String,不可为空

ro.product.brand

例:HW

品牌

String,不可为空

ro.product.model

例:LYA_AL00

型号

String,不可为空

ro.build.id

Build 标签

ro.build.display.id

Build 版本号

ro.product.name

例:LYA_AL00

产品名称

String,不可为空

ro.product.device

例:HWLYA

设备信息

String,不可为空

ro.product.board

例:LYA

主板名

String,不可为空

ro.bootloader

BootLoader 版本号

ro.build.type

例:user/userdebug/eng

正式版本/调试版本

ro.build.fingerprint

系统指纹

ro.build.date.utc

固件编译时间戳

ro.build.user

固件编译用户

ro.build.host

固件编译主机

ro.build.description

编译描述信息

ro.build.version.incremental

内部版本号

ro.build.version.sdk

例:28/29/30

SDK 版本号

ro.build.version.codename

codename

ro.install.allow_downgrade

例:true/false

是否允许降级安装应用
true:(默认值)允许
false:禁止

su_white_list

例:com.example1;com.example2

需要开启SU权限的应用包名(只能通过持久化参数设置)

多个应用包名用英文分号隔开,包名必须为小写,也可传入 “all” 对实例中的所有应用生效;单个属性值的长度不可超过91个字符

su_white_list;su_white_list.1;su_white_list.2;...su_white_list.31

需要开启SU权限的应用包名(只能通过持久化参数设置)

如通过 su_white_list 设置时属性值长度超过91个字符,可使用该方法设置

Settings 属性列表

云手机服务支持在创建实例时设置云手机属性、在更新实例属性时对实例属性进行修改。

global

电池设置

属性(key)

属性值(value)

属性说明

fake_battery_charger_online

1:充电
0:放电

设置电池充电/放电状态

fake_battery_level

取值范围:[10-100]

设置电池电量

fake_battery_simulating_switch

on:开启
off:关闭

开启/关闭电池电量动态模拟

fake_battery_level_threshold_upper

取值范围:[3-100]

设置开启动态充放电模拟充电阈值

fake_battery_level_threshold_lower

取值范围:[3-upper]

设置开启动态充放电模拟放电阈值

fake_battery_charging_speed

默认 60,单位:秒

设置充电速度(电量每增加1%所需的耗时)

fake_battery_discharging_speed

默认 600,单位:秒

设置放电速度(电量每降低1%所需的耗时)

音视频注入设置

属性(key)

属性值(value)

属性说明

mic_configuration

例:"44100 1 2"

麦克风音频数据注入参数:
采样率(支持多种采样率)
声道数(支持单双声道)
采样深度(支持8位:1 byte 和16位:2 byte)

camera_file_preview

on:开启
off:关闭

开启/关闭将 mp4 视频文件注入到云手机系统的虚拟摄像头中使用的功能

camera_file_preview_path

例:/sdcard/playmp4/test1.mp4

需要将 mp4 视频文件注入到云手机系统的虚拟摄像头中使用时,设置待播放的 mp4 文件的路径(只需指定 /sdcard/playmp4/ 目录下的任意一个 mp4 文件作为开始即可,该文件播放完会,系统会自动寻找目录下的其他 mp4 文件进行循环播放)

应用安装设置

属性(key)

属性值(value)

属性说明

settings.install_filter

1:仅允许白名单应用安装
2:禁止黑名单应用安装

指定应用安装模式,与以下 install_whitelist 和 install_blacklist 属性配合使用

settings.adb_install_filter

1:仅允许 adb 白名单应用安装
2:禁止 adb 黑名单应用安装

指定adb应用安装模式,与以下 install_whitelist 和 install_blacklist 属性配合使用

settings.install_whitelist

例:com.example1;com.example2

允许安装的应用包名(应用安装白名单),多个应用包名用英文分号隔开

说明

属性值的长度不可超过 4096 个字符

settings.install_blacklist

例:com.example1;com.example2

禁止安装的应用包名(应用安装黑名单),多个应用包名用英文分号隔开

说明

属性值的长度不可超过 4096 个字符

packages_enabled

例:com.example1,com.example2

恢复显示被隐藏的应用包名,多个应用包名用英文逗号分隔开

packages_disabled

例:com.example1,com.example2

隐藏已安装的应用包名,多个应用包名用英文逗号分隔开

hide_accessibility_for_apps

  • (推荐)传入具体的应用名称,可同时传入多个,以半角逗号(,)间隔。例:com.xxx.yyy, com.yyy.zzz
  • 传入 all 表示所有应用

用于隐藏指定应用的无障碍服务,隐藏后指定应用的无障碍服务权限无法被其他应用感知到

传感器设置

属性(key)

属性值(value)

属性说明

inject_sensor/switch

on:开启
off:(默认值)关闭

是否开启自定义传感器设置,示例:settings put global inject_sensor/switch "on"

inject_sensor/xxx "a,b,c"

例:inject_sensor/acceleration "6.33,4.11,2.00"

为对应传感器设置自定义值,当 inject_sensor/switchon 时生效。 xxx 代表传感器名称,a、b、c 代表具体参数个数及数值,多个值中间以英文逗号分隔:

  • acceleration:加速度传感器,可设置 3 个数值,即 x、y、z 三轴的加速度数值,单位为 m/s^2
  • gyroscope:陀螺仪传感器,可设置 3 个数值,即 x、y、z 三轴的角速度数据, 单位为 radians/second
  • light:光传感器,可设置 1 个数值,即光线强度,单位为 lux
  • magnetic:磁力传感器,可设置 3 个数值,即 x、y、z 三轴的环境磁场数据,单位为 uT
  • proximity:近程传感器,可设置 3 个数值,即检测物体和手机的距离, 单位为 cm
  • orientation:方向传感器,可设置 3 个数值,即 azimuth、pitch、roll 三轴角度数值,单位为°
  • gravity:重力传感器,可设置 3 个数值,即 x、y、z 三个方向的重力分量,单位为 m/s^2

注意

若同时设置了本参数和 inject_sensor/mode,则以后者的设置为最高优先级。

inject_sensor/mode

0:(默认值)读取各传感器的传值;
1:模拟手持状态;
2:模拟步行状态;
3:模拟“摇一摇”状态。

预设的传感器模拟模式,用于控制传感器模拟真人行为,int 型参数,当 inject_sensor/switchon 时生效。

注意

  • 传感器数据注入过程中,可通过将本参数设置为空值来停止注入。
  • 该参数需配合 2025 年 1 月 3 日及之后发布的公共镜像使用。

定位服务设置

属性(key)

属性值(value)

属性说明

gps_settings_support

on:打开
off:关闭

是否开启地理位置模拟。开启后,当有应用请求位置信息时,系统会每隔 1s 发送一次当前位置。

gps_inject_info

"longitude,latitude,altitude,speed,bearing,accuracy"

位置信息,设置 gps_settings_supporton 时可用。可设置以下六个值,以英文逗号分隔:
经度(必填)
维度(必填)
海拔(m)
速度
方位角
定位精度(m)

其他设置

属性(key)

属性值(value)

属性说明

device_name

设置->关于手机->设备名称

procCpuInfo

/proc/cpuinfo

procVersion

/proc/version

procAsoundCard

例:
"0 [AMLAUGESOUND ]: AML-AUGESOUND - AML-AUGESOUND\n\tAML-AUGESOUND\n1 [D27 ]: USB-Audio - DTEN Android Mic 27\n\tDTEN Lab DTEN Android Mic 27 at usb-xhci-hcd.0.auto-1.1.2.1, high speed\n"

模拟声卡信息,/proc/asound/cards

procSysKernelRandomBootId

/proc/sys/kernel/random/boot_id

wifi_scanresults

"Test,ab:cd:01:ef:45:89,1245,0,[WPA2-EAP-CCMP][RSN-EAP-CCMP][ESS], -60, 2000,100000,22,33,20, 0,0,0"

WiFi 扫描结果:
(结果中的参数依次为:ssid,bssid,hessid,anqpDomainId,capabilities,level,frequency,timestamp,distance,distanceSd,channelWidth,centerFreq0,centerFreq1,is80211McRTTResponder; 总共14个数据,缺一不可,用英文逗号隔开。如注入多个 WiFi,则在每个数据段使用分号 ; 隔开)

launcherImg

"http://xxx.abc.com/download/abc.png"

从指定的 URL 下载图片,替换云手机 Launcher 的背景图

sim_switch

1:开启
0:关闭

开启/关闭 SIM 卡

hide_sim_switch

1:隐藏
0:默认设置,显示

显示/隐藏 SIM 卡开关

enableScriptAutoRun

0:(默认值)关闭
1:开启,仅首次满足 scripts_autorun_configs 中配置的触发条件时,自动执行脚本
2:开启,且每次满足 scripts_autorun_configs 中配置的触发条件时,均自动执行脚本

是否开启配置脚本自启动功能

scripts_autorun_configs

例(多个脚本的配置用英文分号隔开):
path1,time1,trigger1;path2,time2,trigger2

脚本自启动的详细配置:

  • path:脚本文件的绝对路径,必填,例:/path/for/script.sh
  • time:脚本启动时机,可选项:
    • 0:开机完成后启动
    • 1:云机实例就绪后启动(默认值)
    • 2:应用加载完成后启动
  • trigger:脚本执行触发条件,可选,当 time=2 时,需要填写应用的包名

locale_language

例:
zh-CN
en-US

国家语言代码(如果传入不支持的语言,则不生效)

time_zone

例:
Asia/Chongqing
America/Chicago

时区代码(如果传入不支持的时区,则不生效)

secure

属性(key)

属性值(value)

属性说明

android_id

Android ID

location_mode

  • 0(关闭)
  • 3(打开)

GPS 开关

bluetooth_name

字符串类型

蓝牙名称

bluetooth_address

例:AC:23:3F:6B:5D:63

蓝牙 MAC 地址

navigationbar_switch

  • on(显示)
  • off(隐藏)

导航栏开关

statusbar_switch

  • on(显示)
  • off(隐藏)

状态栏开关

hide_features_for_pkgs

应用包名1,应用包名2,应用包名3

如需针对某些应用进行关键字隐藏,使用该字段可设置目标应用包名列表。多个包名以英文逗号“,”分隔,字段长度上限为 65536 个字符。请结合 hide_features_keywords 一起使用。命令示例:

adb shell settings put secure hide_features_for_pkgs com.example.app1,com.example.app2

注意:

  1. 设置该属性后,需重启应用以使配置生效。建议先参照以下命令强制停止当前的应用进程:adb shell am force-stop com.xxx.yyy,com.yyy.zzz。
  2. 该属性需配合 2025/4/21 及之后日期发布的镜像使用。

hide_features_keywords

示例:abc,def,gh

如需针对某些应用进行关键字隐藏,使用该字段可设置需要隐藏的关键字。多组关键字以英文逗号“,”分隔。请结合 hide_features_for_pkgs 一起使用。命令示例:

adb shell settings put secure hide_features_keywords abc,def,gh

system

属性(key)

属性值(value)

属性说明

launcher3_remove_drawer

1:打开,图标平铺到桌面
0:(默认值)关闭,原生抽屉样式。

launcher 样式更改。

block_host_dns

例:www.baidu.com,www.163.com

域名黑名单,即云手机实例禁止访问的域名名单。多个域名请使用英文逗号 “,” 隔开,支持使用 * 通配符。
该属性传入空值即可取消黑名单。

block_ip

例:0.0.0.0,1.1.1.1

IP 黑名单,即云手机实例禁止访问的 IP 名单。多个 IP 请使用英文逗号 “,” 隔开,支持使用 * 通配符。
该属性传入空值即可取消黑名单。

附件

触控事件注入说明

通过 setprop persist.sys.sendevent.enable true 开启触控事件注入说明如下:

  1. 开启触控事件注入后支持辅助功能监听Key事件。
  2. 支持的 input 节点为 ByteInputDevice。可通过 getevent -l 命令,查询名称为 ByteInputDevice 的设备。参考以下示例:
130|7293733028013316891-0:/ # getevent -l
add device 1: /dev/input/event4
  name:     "ByteInputDevice"

写入触控事件(getevent 可以看到结果),参考以下示例:

adb shell sendevent /dev/input/event4 1 330 1
adb shell sendevent /dev/input/event4 0 0 0
adb shell sendevent /dev/input/event4 1 330 0
adb shell sendevent /dev/input/event4 0 0 0

测试脚本(模拟触控事件)

#!/bin/bash
# 模拟点击事件
sendevent /dev/input/event6 3 57 25
sendevent /dev/input/event6 1 330 1
sendevent /dev/input/event6 1 325 1
sendevent /dev/input/event6 3 53 353 # 点击坐标x,需要设置整数
sendevent /dev/input/event6 3 54 1234 # 点击坐标y,需要设置整数
sendevent /dev/input/event6 3 48 25
sendevent /dev/input/event6 3 48 7
sendevent /dev/input/event6 3 58 11
sendevent /dev/input/event6 0 0 0
sendevent /dev/input/event6 4 57 ffffffff
sendevent /dev/input/event6 1 330 0
sendevent /dev/input/event6 1 325 0
sendevent /dev/input/event6 0 0 0

将上面的代码,保存为 sendevent.sh,push 到 Android 实例里面执行

# push 到 Android的/data/local/tmp目录下
adb push sendevent.sh /data/local/tmp/
# 修改为可执行权限
adb shell chmod a+x /data/local/tmp/sendevent.sh
# 进入到Android的shell环境里面,执行脚本
adb shell
# ./data/local/tmp/sendevent.sh

显示触摸屏操作:

settings put system show_touches 1
settings put system pointer_location 1