คู่มือนี้จะอธิบายการตั้งค่าสภาพแวดล้อมเพื่อสร้างการทํางาน โดยใช้ทั้ง Actions SDK และ Action Builder โดยจะต้องดําเนินงานต่อไปนี้
- ติดตั้ง Node.js: คุณต้องมีสภาพแวดล้อมรันไทม์นี้เพื่อใช้ไลบรารีการดําเนินการของ Node.js
- ติดตั้ง Firebase CLI: เครื่องมือบรรทัดคําสั่งนี้ช่วยให้คุณพัฒนาและใช้ทรัพยากร Dependency ของ Firebase เช่น เว็บแอปสําหรับ Interactive Canvas ไปยังโฮสติ้งของ Firebase ได้
- ติดตั้งเครื่องมือบรรทัดคําสั่ง GPA: เมื่อพัฒนาด้วย Actions SDK คุณใช้เครื่องมือนี้ในการสร้าง จัดการ และทําให้แพ็กเกจการดําเนินการใช้งานได้
- สร้างโปรเจ็กต์การดําเนินการ: โปรเจ็กต์การดําเนินการคือคอนเทนเนอร์ที่เหมาะสมสําหรับการดําเนินการด้านการสนทนา คุณต้องสร้างคอนโซลขึ้นในคอนโซลการทํางานก่อน จึงจะเริ่มสร้างได้
- เริ่มต้นและทําให้ตัวอย่างใช้งานได้: ตัวอย่างแบบง่ายนี้จะแสดงวิธีเริ่มต้นสร้างการดําเนินการที่ขับเคลื่อนโดย Interactive Canvas
เมื่อเริ่มต้นอย่างรวดเร็วนี้ คุณจะสามารถซิงค์โปรเจ็กต์การดําเนินการระหว่างสภาพแวดล้อมการพัฒนาในระบบกับประสบการณ์การใช้งานเว็บจากเครื่องมือสร้างการดําเนินการได้
ติดตั้ง Node.js และ Firebase CLI
ดาวน์โหลดและติดตั้ง Node.js ตามเอกสารประกอบ Node.js เพื่อใช้คลังการดําเนินการของเรา นอกจากนี้ การติดตั้ง Node.js ยังช่วยให้คุณติดตั้ง Firebase CLI ด้วย npm ขึ้นไป เพื่อเรียกใช้การดําเนินการตามการใช้งานของบริบทภายในเครื่องได้
ติดตั้งและตั้งค่า Firebase CLI ตามเอกสารประกอบใน Firebase Firebase CLI ช่วยให้คุณทําให้เว็บแอป Canvas เชิงโต้ตอบใช้งานได้กับโฮสติ้งของ Firebase และการทําให้ Cloud Functions for Firebase ใช้งานได้ด้วยตนเองหากจําเป็น
ติดตั้งเครื่องมือบรรทัดคําสั่ง gactions
ติดตั้งเครื่องมืออินเทอร์เฟซบรรทัดคําสั่ง (CLI) ด้วยการดาวน์โหลดแพ็กเกจการติดตั้ง คลายการแพคแพ็กเกจ และกําหนดค่าเส้นทางการดําเนินการ
หากต้องการติดตั้งและกําหนดค่าช่องว่าง ให้ทําตามขั้นตอนต่อไปนี้
ดาวน์โหลดแพคเกจที่เหมาะสมสําหรับระบบปฏิบัติการของคุณ:
แพลตฟอร์ม Package ตรวจสอบข้อผิดพลาด Windows ดาวน์โหลด SHA256 Linux ดาวน์โหลด SHA256 Mac OS ดาวน์โหลด SHA256 แตกแพ็กเกจไปยังตําแหน่งที่คุณต้องการและเพิ่มไบนารีไปยังตัวแปร
PATH
ของสภาพแวดล้อม หรือแตกแพ็กเกจไปยังตําแหน่งที่อยู่ในตัวแปรPATH
อยู่แล้ว (เช่น/usr/local/bin
)ใน Linux และ Mac ให้เปิดใช้สิทธิ์การดําเนินการหากจําเป็น
chmod +x PATH_TO/gactions
เรียกใช้คําสั่งต่อไปนี้เพื่อตรวจสอบสิทธิ์ CLI คําสั่งนี้จะเริ่มขั้นตอนการตรวจสอบสิทธิ์และต้องใช้เว็บเบราว์เซอร์
gactions login
เมื่อกระบวนการเสร็จสมบูรณ์แล้ว CLI จะตรวจสอบสิทธิ์โดยอัตโนมัติ
สร้างและตั้งค่าโครงการ
คุณต้องสร้างโปรเจ็กต์ในคอนโซล Actions และให้สิทธิ์เข้าถึงโปรเจ็กต์ก่อน จึงจะใช้เครื่องมือบรรทัดคําสั่งของช่องว่างได้ ในการสร้างและตั้งค่าโครงการ ให้ทําดังนี้
- ไปที่คอนโซล Actions
- คลิกโครงการใหม่ จากนั้นป้อนชื่อโครงการแล้วคลิกสร้างโครงการ
- เลือกหมวดหมู่ แล้วคลิกถัดไป
- เลือกโครงการเปล่า แล้วคลิกเริ่มสร้าง
- เปิดใช้ Actions API ในคอนโซล Google Cloud โดยทําตามวิธีการในหัวข้อเปิดหรือปิดใช้ API การดําเนินการนี้ช่วยให้ช่องว่างโต้ตอบกับโปรเจ็กต์ได้
ดูตัวอย่าง Hello World
ตัวอย่างวิดีโออินเทอร์แอกทีฟของ hello World จะแสดงวิธีการสร้างโปรเจ็กต์การดําเนินการ ที่เรียบง่ายด้วย Action เดียวที่ขับเคลื่อนโดย Interactive Canvas
สร้างไดเรกทอรีที่ว่างเปล่าและเริ่มต้นตัวอย่าง Interactive Canvas ในไดเรกทอรีนั้น เช่น โค้ดต่อไปนี้จะเริ่มต้นตัวอย่างในไดเรกทอรี
interactive-canvas-sample/
ซึ่งใช้เป็นตัวอย่างตลอดทั้งเอกสารนี้gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample
เปิดไฟล์
interactive-canvas-sample/sdk/settings/settings.yaml
และเปลี่ยนค่าของช่องprojectId
เป็นรหัสของโปรเจ็กต์
ทําให้ใช้งานได้และทดสอบตัวอย่าง
หลังจากตั้งค่าตัวอย่างแล้ว คุณจะทําให้เว็บแอป Interactive Canvas และโปรเจ็กต์ Actions ใช้งานได้ ขั้นตอนนี้จะสร้างโปรเจ็กต์การดําเนินการเวอร์ชันร่างที่คุณทําให้ใช้งานได้กับเครื่องมือจําลอง Actions เพื่อดูตัวอย่างและการทดสอบ
จากไดเรกทอรี
interactive-canvas-sample/
ให้เรียกใช้คําสั่งต่อไปนี้เพื่อทําให้เว็บแอป Interactive Canvas ใช้งานได้ (เนื้อหาของไดเรกทอรีpublic/
)firebase deploy --project PROJECT_ID --only hosting
คุณดูเว็บแอปที่แสดงผลได้ใน URL ที่ Firebase CLI แสดงในเบราว์เซอร์
https://PROJECT_ID.web.app
เปิดไฟล์
interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js
และเปลี่ยนค่าของตัวแปรCANVAS_URL
เป็น URL ของเว็บแอปของโปรเจ็กต์const CANVAS_URL = 'https://PROJECT_ID.web.app';
จากไดเรกทอรี
interactive-canvas-sample/sdk/
ให้เรียกใช้คําสั่งต่อไปนี้เพื่อพุชโปรเจ็กต์ Actions เวอร์ชันในเครื่องไปยังคอนโซลเป็นเวอร์ชันร่างgactions push
เรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรี
interactive-canvas-sample/sdk/
เพื่อทดสอบโครงการ Actions ในเครื่องมือจําลองgactions deploy preview
เปิดลิงก์ที่เครื่องมือบรรทัดคําสั่งกลับมาเพื่อไปยังเครื่องจําลอง
ในเครื่องมือจําลอง ให้ป้อน "ตัวอย่างการพูดคุยกับ Canvas แบบอินเทอร์แอกทีฟ" เพื่อเริ่มดําเนินการ คุณจะเห็นรูปสามเหลี่ยมที่หมุนโดยเว็บแอปที่ทําให้ใช้งานได้ที่
https://PROJECT_ID.web.app
รูปที่ 1 เครื่องจําลองแสดงตัวอย่างโปรเจ็กต์การดําเนินการ