MCSDevice
Last updated
Last updated
為了連接到 MCS 伺服器、並與 MCS 上的測試裝置傳送資料，需使用 MCSDevice 類別建立運作在開發板上的 MCS 裝置物件。更多細節請參考MCS 簡介。
MCSDevice()
建立能連接到 MCS 伺服器的裝置。
Syntax
MCSDevice device(device_id, device_key)
MCSDevice device(device_id, device_key, mcs_server_url, mcs_server_port)
Parameters
device_id：在 MCS 上建立的測試裝置 ID。
device_key：在 MCS 上建立的測試裝置 key。
mcs_server_url：MCS 伺服器的位置。此參數為選擇性帶入，若沒有提供的話，預設會連線至 ""。
MCS Global：欲連接至 MCS Global，請瀏覽 頁面並在 MCS API 的伺服器 URL 指定 ""。
MCS China：欲連接至 MCS China，請瀏覽 頁面並在 MCS API 的伺服器 URL 指定 ""。
mcs_server_port：MCS 伺服器的通訊埠。此參數為選擇性帶入，若沒有提供的話，預設連接埠為 80。
Returns
device 為 MCSDevice 類別的實體。
addChannel()
將資料通道加入至 MCSDevice 實體。
Syntax
device.addChannel(data_channel_instance)
Parameters
data_channel_instance：繼承自 MCSDataChannel 的類別實體。
Returns
無
connect()
Description
連接至指定的 MCS 伺服器。
Syntax
device.connect()
Parameters
device：MCSDevice 類別實體。
Returns
若連接成功則回傳布林值 true，反之若有錯誤發生則回傳 false。
connected()
Description
檢查連線是否成功。
Syntax
device.connected()
Parameters
device：MCSDevice 類別實體。
Returns
若連線成功則回傳布林值 true，反之若連線已中止則回傳 false。
process()
Description
處理來自 MCS 伺服器的資料。
Syntax
device.process(timeout_value)
Parameters
timeout_value：此參數為選擇性帶入。用來指定多久時間後 (單位為 millisecond 毫秒) 繼續執行 loop() 函式內後續的程式碼。若沒有指定的話，則以 setDefaultTimeout() 函式的設定值為準。預設的 timeout 時間為 30 秒。
Returns
無
setDefaultTimeout()
Description
設定 process() 函式所使用的 timeout 值。
Syntax
device.setDefaultTimeout(default_timeout_value)
Parameters
default_timeout_value：欲設定的 timeout 值 (單位為 millisecond 毫秒)。
Returns
無