การจัดการแอปพลิเคชัน

คุณสามารถสร้าง app_id และ secret_key ซึ่งจำเป็นสำหรับการผสานรวมกับแอปบนอุปกรณ์เคลื่อนที่ของคุณ

โดยทั่วไป แอปของคุณต้องใช้ App Key เพียงหนึ่งชุด แต่หากให้บริการมากกว่าหนึ่งแอป คุณสามารถสร้างและจัดการ App Key แยกสำหรับแต่ละแอปได้

SORI API Server ใช้ app_id และ secret_key เพื่อยืนยันตัวตนของ SDK ข้อมูลเหล่านี้เปรียบเสมือนรหัสผ่าน จึงควรเก็บรักษาให้ปลอดภัย หากสงสัยว่า App Key ถูกเปิดเผย คุณสามารถเพิกถอนและสร้างใหม่ได้ใน SORI Console

การสร้าง App ID และ Secret Key

หากต้องการสร้าง App Key ให้คลิก + ที่ด้านล่างขวาของหน้า

ป้อนชื่อเพื่อใช้ระบุ App Key แต่ละรายการ แล้วคลิก Create จากนั้น App ID และ Secret Key ที่สร้างขึ้นจะปรากฏในรายการ

หากคุณดูแลหลายแอป สามารถสร้าง App Key แยกกันด้วยวิธีเดียวกันได้

การดาวน์โหลดโปรเจกต์ตัวอย่าง

เมื่อสร้าง App Key แล้ว คุณสามารถดาวน์โหลดโปรเจกต์ตัวอย่างที่พร้อมคอมไพล์สำหรับแพลตฟอร์มของคุณได้ โดยไม่ต้องตั้งค่าข้อมูลรับรองด้วยตนเอง

คลิก ⁝ ทางขวาของวันที่สร้าง APP Key แล้วเลือก รับโค้ด...

กล่องโต้ตอบ ดาวน์โหลดโปรเจกต์ตัวอย่าง มีให้เลือกสามแพลตฟอร์ม:

แพลตฟอร์ม	โปรเจกต์ตัวอย่าง
Android	SORI Example Android Kotlin
iOS	SORI Example iOS Swift
Flutter	SORI Example Flutter

เมื่อเลือกแพลตฟอร์ม SORI Console จะสร้างไฟล์ ZIP จากที่เก็บโปรเจกต์ตัวอย่างสาธารณะที่ตรงกัน โดยใส่ app_id และ secret_key ของแอปพลิเคชันนี้ไว้ให้แล้ว จึงไม่ต้องแก้ไขข้อมูลรับรองด้วยตนเอง

TIP

การสร้างไฟล์ใช้เวลาสักครู่ กรุณาเปิดกล่องโต้ตอบไว้จนกว่าเบราว์เซอร์จะเริ่มดาวน์โหลด

ไฟล์ ZIP ทุกไฟล์จะมี SORI_CREDENTIALS_NOTICE.md ซึ่งระบุไฟล์ที่เก็บข้อมูลรับรองและคำสั่งรันของแพลตฟอร์มนั้น

การรันโปรเจกต์ที่ดาวน์โหลด

แตกไฟล์ ZIP แล้วรันโปรเจกต์จากไดเรกทอรีราก

Android — ข้อมูลรับรองจะถูกเขียนลงใน local.properties เป็น SORI_APP_ID และ SORI_SECRET_KEY ซึ่งการบิลด์ด้วย Gradle จะส่งต่อไปยังแอป

./gradlew installDebug

iOS — ข้อมูลรับรองจะถูกกำหนดไว้ใน SORIExample/ContentView.swift เปิดโปรเจกต์ใน Xcode แล้วรันบนอุปกรณ์จริง

open SORIExample.xcodeproj

Flutter — ข้อมูลรับรองจะถูกเขียนลงใน sori_credentials.json และส่งเข้าไปตอนบิลด์ ดังนั้นคำสั่งรันต้องระบุไฟล์นี้ด้วย

flutter pub get
flutter run --dart-define-from-file=sori_credentials.json

WARNING

โปรเจกต์ที่ดาวน์โหลดมีค่า secret_key ของแอปพลิเคชันนี้ อย่าคอมมิตลงในที่เก็บโค้ดใด ๆ และอย่าแชร์ไฟล์ ZIP ตามที่เป็น หาก Secret Key รั่วไหล ให้ลบ APP Key นั้นและสร้างใหม่

ดูรายละเอียดการผสานรวมทั้งหมดได้ในคู่มือ Android, iOS และ Flutter

การลบ App ID และ Secret Key

หาก APP ID และ SECRET KEY ถูกเปิดเผย คุณสามารถเพิกถอนแอปได้

WARNING

โปรดทราบว่าไม่สามารถกู้คืนแอปได้หลังจากลบ และ SDK ที่ใช้ข้อมูลนี้จะไม่สามารถทำงานต่อได้

คุณสามารถลบ APP Key ได้โดยคลิก ⁝ ทางขวาของวันที่สร้าง APP Key