Demo App (SDK 的安裝與 compile)

Demo App

此 SDK 內附一支 Demo App，用來展示各項 API 使用方法。含 source code 😁 方便您上手。👍

安裝

1. 從 本 project 的 release 區 下載對應版本的 GoFIT_SDK-release.aar，置入子目錄 GoFIT_SDK_Demo/app/libs/ 下。

2. 請將您收到的授權檔案 (.crt) 改名為 client_cert.crt，置入子目錄 GoFIT_SDK_Demo/app/src/main/assets 下 (同時，如果您有收到 firmware 的 OTA 更新 image (.hex)，則也請連同一起放置於該目錄下)。

3. 然後就可以 build Demo App 囉!!! Good Luck!!! 👍

Demo App

• 此 SDK 內附一支 Demo App，用來展示上述所列各項 API 使用方法，App 頁面方為三大區塊：
  • 
  • SDK
    • 用來 initialize SDK，開啟 app 後須先執行此功能
  • BLE FUNCTION

    • 分為以下功能

      1. Scan Device
         • 約 10 秒後回傳掃描結果，會顯示 RSSI 最強之裝置 MAC address
      2. New Pairing
         • 新配對 Scan Device 中 RSSI 最強的裝置，不帶有配對碼的連線方式
      3. Connect Device
         • 適合已配對完成之裝置，若連線成功會出現裝置 MAC address
      4. Device Setting
         • 預設設定項目為 12時制、英制單位與啟動斷線提醒
         • 可於 demo app 中自行設定其他項目
      5. Get Fitness Data
         • 會有 progress value 顯示，為一累計值
         • SDK 會過濾無效資料，累計值不一定相等於最後回傳個數
      6. Clear Data
         • 執行 Get Fitness Data 後，再執行此 function 可清除已同步資料
      7. Device Data Initialization
         • 清除裝置螢幕上之步數資料
      8. Device Firmware Update
         • 執行韌體升級，會有 progress value，以百分比表示
      9. Device Disconnect
         • 將當前連線裝置斷線，以便下一個裝置連線

    • 因本 SDK 非 reentrant，非 multi-threaded 使用，所以建議的 API 操作流程為 :

      • 資料同步
        • 新配對裝置 : (1) -> (2) -> (5) -> (6) -> (9)
        • 已配對過裝置 : (3) -> (5) -> (6) -> (9)
      • 裝置設定
        • 新配對裝置 : (1) -> (2) -> (4) -> (9)
        • 已配對過裝置 : (3) -> (4) -> (9)
      • 韌體升級
        • 新配對裝置 : (1) -> (2) -> (8)
        • 已配對過裝置 : (3) -> (8)
      • 在已連線狀態下，(4)、(5)、(6)、(7)、(8) 皆是可重複執行之 API

    • DEVICE STATUS

      • 用來顯示當前連線裝置之訊息
        1. Connect Status
           • 顯示已連線或未連線
        2. Battery
           • 顯示電量
        3. MAC Address
           • 顯示 MAC Address
        4. SN
           • 顯示裝置序號
        5. FW Version
           • 顯示韌體版本