[LattePanda] 使用LattePanda打造Line機器人

本文章將來介紹一下如何在LattePanda上面部署一個LINE智慧對話機器人，並拿它來控制LattePanda上的Arduino IO。

STEP1. LINE開發者帳號與取用LINE Message API

首先, 我們需要先在 LINE 的開發者官方網站 (https://developers.line.me/en/) 註冊一個LINE開發者帳號。

請點選右邊的 Start using Message API， 接下來系統將會提示使用者完成三個設定步驟以完成新增一個通道。

首先，你必須先選取一個提供者，也就是告訴系統是誰提供這個APP的服務。

接下來，請填上關於取用Messaging API 的必要資訊。

最後一步，確認玩設定都沒錯後，按下confirm，你將會看到一個新增的通道出現在一開始的console頁面。

STEP2. 安裝Node.js與下載 line-bot-sdk-nodejs library

在我們繼續完成 LINE Bot細部設定之前，我們必須先安裝一下LINE Bot的軟體開發環境。 我們開發LINE Bot所使用的程式語言是 node.js，所以請點選以下網址(https://nodejs.org/en/download/) 將Windows版本的node.js下載下來並安裝在LattePanda上面。

安裝完後，我們還需要用到LINE Bot SDK ，請到以下的github 網址(https://github.com/line/line-bot-sdk-nodejs) 下載並解壓縮官方的node.js 版 LINE Bot SDK。

如果有讀者想要查這個LINE Bot SDK的詳細使用資訊的話，可以點選此網址 (https://line.github.io/line-bot-sdk-nodejs/) 到官方的gitbook上看進一步的API使用說明，以及如何去用javascript來撰寫機器人的對話功能。

最後請打開命令提示字元（按下快捷鍵 <Win+R> 並輸入”cmd”叫出command prompt）， 並輸入以下的命令將工作目錄移動到方才解壓縮的LINE Bot SDK資料夾下的echo-bot範例（line-bot-sdk-nodejs/examples/echo-bot）。

cd THE_ECHO-BOT_EXAPMLE_FOLDER(ex: C:\Users\lattepanda\line-bot-sdk-nodejs\examples\echo-bot)

接下來請輸入以下的指令來安裝需要用到的node.js套件，在這個範例中，我們會需要安裝兩個額外的套件，一個是用來開啟伺服器的express套件，另外一個則是LINE Bot的SDK函式庫。

npm install

STEP3. 用ngrok來將本地伺服器開放到網路上

在前面的步驟中，我們雖然可以開啟一個本地的伺服器，但是為了要能夠取用網路上的 LINE Messaging API，我們必須使用一些工具來將LattePanda上的服務開放到雲端上。

請點選此網址(https://ngrok.com/download)來下載ngrok，這套軟體可以讓使用者在本地伺服器與網際網路建立一個加密的網路通道。

下載完成後，請將壓縮檔解壓縮，並點選ngrok.exe，呼叫出一個命令提示字元。

請在上面輸入以下的指令在localhost的port 3000開啟一個http的通道。

ngrok http 3000

成功開啟後，將會看到如以下的畫面。你將會得到兩個開放的網址，一個是走HTTP，另外一個則是走有加密的HTTPS，請記住這個連結，待會我們將要把這個連接填到LINE Bot上的回呼位址上。

STEP4. 設定Channel Secret/Webhook/Token

請點選剛剛在 STEP2 新增的APP，我們將要完成LINE Bot上最後三個主要的溝通憑證。

第一個是設定頻道的金鑰，請按下issue並複製這段的金鑰到echo-bot的範例資料夾中的index.js檔中。

接下來，同樣地也請點選issue並把channel的access token貼到index.js的config中。

// create LINE SDK config from env variables
const config = {
  channelSecret: 'PASTE_YOUR_CHANNEL_SECRET',
  channelAccessToken: 'PASTE_YOUR_ACCESS_TOKEN',
};

最後，我們的APP需要設定一個webhook網址，請填上你在STEP3 中開啟的ngrok所得到的網址，並在最後面加上 “/callback” 。例如： “20c21167.ngrok.io/callback”.

STEP5. LineBot 測試

請用智慧型手機打開LINE APP並掃描這個機器人的QR code來加好友。

接下來回到LattePanda上輸入以下的指令執行echo-bot程式並確認ngrok通道已經正確開啟了且webhook的網址也有設定在LINE Bot console 頁面了。

node .

請在上面手機上用LINE打上一些文字看看LINE Bot會有什麼反應吧！

STEP6. 使用 serial來與Arduino做溝通

請下載以下的Arduino程式碼到 LattePanda上的 Arduino Leonardo核心。

這個程式中，我們時做了一個簡單的serial控制的LED開關，如果使用者在序列埠監控視窗中輸入一個大寫的T，LED燈就會被打開，如果輸入大寫的F，LED燈則會被關閉。

void setup()
{
    Serial.begin(9600);
    pinMode(LED_BUILTIN, OUTPUT);
    
}

void loop()
{
    if(Serial.available())
    {
        char cmd = Serial.read();
        if(cmd == 'T')
            digitalWrite(LED_BUILTIN, HIGH);
        else if(cmd == 'F')
            digitalWrite(LED_BUILTIN, LOW);
        else
            Serial.println("Enter T/F to turn ON/OFF LED");
    }
}

STEP7. 在LattePanda上使用LineBot 來控制LED

我們想在LattePanda上使用node.js取用serial來控制LED燈，所以我們必須再新增一個新的node.js函式庫。請在範例echo-bot中的資料夾中打開 package.json ，並如以下的範例加上 serialport 這個套件來讓node.js可以使用Serial來與Arduino做溝通。

package.json

{
  "name": "echo-bot",
  "version": "0.0.0",
  "description": "An example LINE bot just to echo messages",
  "main": "index.js",
  "scripts": {
    "start": "node ."
  },
  "dependencies": {
    "@line/bot-sdk": "^5.0.0",
    "express": "^4.15.2",
    "serialport": "^6.0.4"
  }
}

改完之後別忘了輸入以下的指令來更新node.js的套件。

npm install

現在我們要在原本的 echo-bot 中的index.js 程式中加入Serial的溝通功能。

首先，請如以下的範例加入serialport的設定，並注意設定好指定的COM Port，也就是在LattePanda上的Arduino Leonardo連接到的COM Port，例如：COM2。

index.js

'use strict';

const line = require('@line/bot-sdk');
const express = require('express');
const SerialPort = require('serialport');
const serialPort = new SerialPort('COM2', {
    baudRate: 9600
});

最後請修改echo-bot預設的handler函式中的功能，加入以下的程式碼好讓node.js根據不同的情形透過Serial送出大寫的T跟F到Arduino 。

index.js

// event handler
function handleEvent(event) {
  if (event.type !== 'message' || event.message.type !== 'text') {
    // ignore non-text-message event
    return Promise.resolve(null);
  }

  if(event.message.text == 'ON') {
      serialPort.write('T');
      const echo = {type: 'text', text: 'Turn ON LED'};
      return client.replyMessage(event.replyToken, echo);
  } else if(event.message.text == 'OFF'){
      serialPort.write('F');
      const echo = {type: 'text', text: 'Turn OFF LED'};
      return client.replyMessage(event.replyToken, echo);
  } else {
      // create a echoing text message
      const echo = {type: 'text', text: event.message.text};
      return client.replyMessage(event.replyToken, echo);
  }
}

現在請重新執行index.js並確認ngrok有正確打開（STEP3），接下來就可以在手機上測試看看是否在LINE上輸入ON/OFF，LINE Bot就會去自動開關LattePanda上的LED燈囉！

以下是本文章的範例LINE Bot範例影片。

相關文章：

• LattePanda 開機步驟與連接螢幕
• LattePanda 拿鐵熊貓教學：Arduino與Visual Studio環境設定
• [LattePanda] 作品發表：中文手指閱讀器
• [LattePanda] OpenCV視覺辨識人臉追蹤
• [LattePanda] 使用C# 來做藍牙0 iBeacon的門鎖系統
• [LattePanda] 使用Weather API、Google 雲服務打造氣象預報機器人