選擇用戶端類型

Wear OS 資料層 API 包含多種不同類型的用戶端, 適用於不同類型的資料,以及在不同連線時 conditions.

本頁面將介紹各種用戶端類型,並包含比較 「快速設定」頁面根據這些資訊 找出最適合您應用程式的用戶端類型組合。

資料用戶端

DataClient 物件可讓您讀取或寫入 DataItemAsset

  • 每個 DataItem 都是系統廣播和同步的資訊單位 都會在使用者擁有的所有附近裝置上放送系統會持續儲存 DataItem。 除非資料項目遭到刪除,否則您的裝置可以讀取其內容。

  • Asset 適用於大型資料酬載,例如圖片或媒體檔案。

訊息用戶端

MessageClient 物件可以傳送訊息,且適用於遠端程序 呼叫 (RPC),例如使用 Wear OS 裝置控制應用程式版本 安裝在手持裝置上。

訊息適用於使用 sendMessage() 的單向要求,或適用於 使用 sendRequest() 的要求與回應通訊模型。與資料不同 用戶端,訊息用戶端必須先將節點連上網路, 傳送訊息

sendMessage() 方法是盡可能傳遞至遠端節點。 但不包含任何內建重試機制。如果目標裝置 網路連線開始前中斷,此方法會傳回 TARGET_NODE_NOT_CONNECTED

管道用戶端

ChannelClient 物件會在 裝置。管道是兩個節點之間的雙向通訊管道 這對於以下用途相當實用:

  • 連上網際網路時,在兩部以上的已連線裝置之間傳輸資料檔案 無法使用。ChannelClient 可節省 DataClient 的磁碟空間, 在與 Cloud 資料同步處理前,在本機裝置上建立資產副本 。
  • 使用 MessageClient 穩定傳送因太大而無法傳送的檔案。
  • 傳輸串流資料,例如來自麥克風的語音資料。

開啟頻道後,可以透過連續位元組傳送及接收資料 而非資料用戶端所需的獨立 DataItem 單位。

負責管理資料流程及確保資料一致性。 管道用戶端提供的自動資料同步處理程度不盡相同 和資料用戶端一樣

用戶端比較

下表比較不同用戶端的功能:

用戶端類型 資料持續性 支援超過 100 KB 的資料? 要使用的網路 擴充功能可以離線作業嗎?
資料用戶端 資料會無限期保存 是 (使用 Asset敬上 物品) 建議使用藍牙。資料備份至雲端;藍牙處於開啟狀態時 但這項備份會以非同步方式完成 是,讀取及寫入資料
訊息用戶端 不會持續且不重試 優先使用藍牙,但若是 有可用的連線
管道用戶端 不保留 (連線導向) 優先使用藍牙,但若是 有可用的連線