Cuttlefish：環境控制

本頁說明如何使用 REST API 或指令列介面，控制 Cuttlefish 裝置中的環境。舉例來說，您可以修改 Cuttlefish 裝置的 Wi-Fi 訊號或 GPS 位置。

服務

cvd env 指令提供下列服務，用於控制 Cuttlefish 環境：

服務	說明
GnssGrpcProxy	控管 Cuttlefish 地理位置功能的 GNSS。
OpenwrtControlService	控管 Openwrt，這是 Cuttlefish Wi-Fi 功能的虛擬 Wi-Fi AP 供應器。
WmediumdService	控制 Wmediumd，這是 Cuttlefish Wi-Fi 功能的無線介質模擬器。
CasimirControlService	控制 Casimir，這是外部 NFC 裝置的模擬器。

使用 REST API 控管環境

本節說明如何透過 <https://localhost:1443> 服務端點使用 Rest API 控管環境。

列出可用的服務或方法

如要取得所有服務的清單，請將 GET 要求和裝置 ID 傳送至下列網址。

https://localhost:1443/devices/DEVICE_ID/services

如要取得服務的所有方法清單，請使用裝置 ID 和服務名稱將 GET 要求傳送至以下網址。

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME

如要取得方法的詳細資訊 (例如要求或回應訊息類型)，請將 GET 要求傳送至以下網址，內容包含裝置 ID、服務名稱和方法名稱。

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME/METHOD_NAME

取得要求和回應類型的詳細資訊

如要取得要求或回應訊息類型的詳細資訊，請將 GET 要求傳送至下列網址，並附上裝置 ID、服務名稱和要求或回應訊息類型。這樣會輸出訊息中每個欄位的所有名稱和類型。接下來，您可以使用這項資訊來編寫 JSON 格式的 proto 訊息，以便傳送遠端程序呼叫 (RPC) 要求。

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME/REQUEST_OR_RESPONSE_TYPE_NAME/type

傳送 RPC 要求以變更環境

如要傳送遠端程序呼叫 (RPC) 要求，以使用 JSON 格式的 proto 呼叫服務方法，請將 POST 要求傳送至下列網址，並附上裝置 ID、服務名稱和方法名稱。JSON 格式的原型必須包含在內文中。

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME/METHOD_NAME

用途範例

以下是 Rest API 透過呼叫 SetTxpower 修改 Wi-Fi 訊號強度的範例。

1. 決定用於修改 Wi-Fi 訊號強度的服務名稱、方法名稱和要求訊息類型名稱。

   1. 如要取得所有可用服務的清單，請將 GET 要求傳送至下列網址。

      https://localhost:1443/devices/cvd-1/services
      

      這是回應範例。

      {"services":["OpenwrtControlService","EchoService","GnssGrpcProxy","WmediumdService"]}
      

   2. 請將 GET 要求傳送至下列網址，取得 WmediumdService 的方法清單。

      https://localhost:1443/devices/cvd-1/services/WmediumdService
      

      這是回應範例。

      {"methods":["ListStations","LoadConfig","ReloadConfig","SetCivicloc","SetLci","SetPosition","SetSnr","SetTxpower","StartPcap","StopPcap"]}
      

   3. 將 GET 要求傳送至下列網址，即可取得 SetTxpower 方法的要求和回應訊息類型相關資訊。

      https://localhost:1443/devices/cvd-1/services/WmediumdService/SetTxpower
      

      以下是回覆範例。

      {"request_type_name":"wmediumdserver.SetTxpowerRequest","response_type_name":"google.protobuf.Empty"}
      

2. 將 GET 要求傳送至下列網址，即可取得 wmediumdserver.SetTxpowerRequest 要求訊息類型的詳細資訊。

   https://localhost:1443/devices/cvd-1/services/WmediumdService/wmediumdserver.SetTxpowerRequest/type
   

   這是回應範例。

   message SetTxpowerRequest {
     string mac_address = 1;
     int32 tx_power = 2;
   }
   

3. 將 RPC 要求傳送至 WmediumdService 服務，藉由傳送 POST 要求至此網址，並使用以下要求主體，將 Wi-Fi 訊號強度修改為所需等級。

   https://localhost:1443/devices/cvd-1/services/WmediumdService/SetTxpower
   

   {"mac_address":"42:00:00:00:00:00", "tx_power":1}
   

   以下是回覆範例。

   {}
   

使用指令列控管環境

本節說明 cvd env CLI 指令可用的子指令。如需更多詳細資訊，請使用 cvd help env 列印說明訊息。

列出可用的服務或方法

如要取得所有服務的清單，請在不使用任何引數的情況下使用 cvd env ls。

cvd env ls

如要取得服務的所有方法清單，請將服務名稱做為引數。

cvd env ls SERVICE_NAME

如要取得詳細資訊 (例如方法的要求或回應訊息類型)，請加入服務名稱和方法名稱。

cvd env ls SERVICE_NAME METHOD_NAME

取得要求和回應類型的詳細資訊

如要取得要求或回應訊息類型的詳細資訊，請使用 cvd env type 指令。這個指令會輸出訊息中每個欄位的所有名稱和類型。接著，您可以使用這項資訊來編寫 JSON 格式的 proto 訊息，以便傳送遠端程序呼叫 (RPC) 要求。

cvd env type SERVICE_NAME REQUEST_OR_RESPONSE_TYPE_NAME

傳送 RPC 要求以變更環境

如要傳送遠端程序呼叫 (RPC) 要求，以便使用 JSON 格式 proto 呼叫服務方法，請使用 cvd enc call 指令。當遠端程序呼叫 (RPC) 要求終止時，介面會列印訊息 Rpc succeeded with OK status，以及含有值的回應訊息 (如果有的話)。

cvd env call SERVICE_NAME METHOD_NAME JSON_FORMATTED_PROTO

用途範例

以下是 cvd env CLI 指令透過呼叫 SetTxpower 修改 Wi-Fi 訊號強度的範例。

1. 決定用來修改 Wi-Fi 訊號強度的服務名稱、方法名稱和要求訊息類型名稱。

   取得所有可用服務的清單。

   cvd env ls
   (Omitted)
   {
     "services" :
     [
       "OpenwrtControlService",
       "EchoService",
       "GnssGrpcProxy",
       "WmediumdService"
     ]
   }

   取得 WmediumdService 的方法清單。

   cvd env ls WmediumdService
   (Omitted)
   {
     "methods" :
     [
       "ListStations",
       "LoadConfig",
       "ReloadConfig",
       "SetCivicloc",
       "SetLci",
       "SetPosition",
       "SetSnr",
       "SetTxpower",
       "StartPcap",
       "StopPcap"
     ]
   }

   取得 SetTxpower 方法的要求和回應訊息類型資訊。

   cvd env ls WmediumdService SetTxpower
   (Omitted)
   {
     "request_type" : "wmediumdserver.SetTxpowerRequest",
     "response_type" : "google.protobuf.Empty"
   }

2. 取得 wmediumdserver.SetTxpowerRequest 要求訊息類型的詳細資訊。

   cvd env type WmediumdService wmediumdserver.SetTxpowerRequest
   (Omitted)
   message SetTxpowerRequest {
     string mac_address = 1;
     int32 tx_power = 2;
   }

3. 將 RPC 要求傳送至 WmediumdService 服務，將 Wi-Fi 訊號強度修改為所需等級。

   cvd env call WmediumdService SetTxpower "{mac_address:'42:00:00:00:00:00', tx_power:1}"
   (Omitted)
   Rpc succeeded with OK status
   {}