跳到主要内容

netcopilot工具

netcopilot是一款帮助开发者进行网络模拟的工具，通过hdc命令行直接调用网络领航员接口，执行网络领航员请求，目前已支持预置场景场景调用和自定义场景调用。

netcopilot工具从API version 20开始支持。

在使用本工具前，开发者需要先获取hdc工具。

使用方法​

命令行说明​

hdc shell netcopilot <命令行参数> <子参数>

命令行参数和子参数可参考下述参数列表，用户也可先输入hdc shell命令，再执行网络领航员请求。

参数列表​

命令行参数子参数功能说明
-hNA输出帮助信息NA
-e0关闭，1开启开启/关闭领航员关闭时其他接口不可用。
-pNA打印网络场景列表默认会打印预置场景列表： 进出电梯 离家断开WLAN 到家连接WLAN 人员拥挤的饭堂 弱信号的地库 乘坐地铁 乘坐高铁（多SIM切换） 高速公路自驾
-s场景id启动场景模拟允许在不同场景间直接切换； 场景模拟需要满足对应网卡要求，进出电梯、离家断开WLAN、到家连接WLAN场景需要同时连接WLAN和蜂窝网络；其他场景需要连接WLAN或蜂窝网络。
-c场景id取消场景模拟NA
-P场景id打印自定义场景详情仅支持自定义场景。
-a自定义场景详情新增自定义场景通过json字符串增加自定义场景，格式示例： { "scenarioName": "自定义场景", "uplinkBandwidth": 1000000, "downlinkBandwidth": 5000000, "uplinkLatency": 200, "downlinkLatency": 200, "uplinkDropRate": 0.05, "downlinkDropRate": 0.01 }
-d自定义场景id删除自定义场景自定义场景id由网络领航员后端生成，通过-p查询列表获取id后，可以通过-d删除。

使用示例​

使用帮助​

> hdc shell netcopilot -h
netcopilot usage:
  -h : show help message
  -e <enable>: 0 for disable, 1 for enable
  -p : print all scenario info
  -s <scenario id>: simulate specified network scenario
  -c : cancel simulating scenario
  -P <scenario id>: print specified scenario details
  -a <custom scenario details>: add custom network scenario
  -d <scenario id>: delete custom network scenario

开启/关闭领航员​

> hdc shell netcopilot -e 0
Disable netcopilot success

> hdc shell netcopilot -e 1
Enable netcopilot success

查看网络场景列表​

> hdc shell netcopilot -p
  +------------+------------------------------+
  | ScenarioID | ScenarioName                 |
  +------------+------------------------------+
  1            | 进出电梯
  2            | 离家断开WLAN
  3            | 到家连上WLAN
  4            | 人员拥挤的饭堂
  5            | 信号弱的地库
  6            | 乘坐地铁
  7            | 乘坐高铁（多SIM切换）
  8            | 高速公路自驾
  +------------+------------------------------+

启动场景模拟​

> hdc shell netcopilot -s 4
Success to simulate scenario 4

停止场景模拟​

> hdc shell netcopilot -c 4
Clear active net scenario success

新增自定义场景​

> hdc shell netcopilot -a "{\"scenarioName\":\"自定义场景1\",\"uplinkBandwidth\":100000,\"downlinkBandwidth\":500000,\"uplinkLatency\":200,\"downlinkLatency\":200,\"uplinkDropRate\":0.05,\"downlinkDropRate\":0.01}"

自定义场景子参数需要转成json字符串。

查看自定义场景详情​

> hdc shell netcopilot -P 1000
Scenario Name: 自定义场景1
Uplink Bandwidth: 100000Kbps
Downlink Bandwidth: 500000Kbps
Uplink Latency: 200ms
Downlink Latency: 200ms
Uplink Drop Rate: 0.05%
Downlink Drop Rate: 0.01%

删除自定义场景​

> hdc shell netcopilot -d 1000
Delete custom scenario success