การใช้งานผ่าน API¶

บทนี้จะแนะนำการใช้งาน API ขั้นพื้นฐาน เพื่อให้คุณได้เรียนรู้วิธีการใช้งาน FIRERPA ในอีกรูปแบบหนึ่ง FIRERPA มี API สำหรับการเขียนโปรแกรมมากกว่า 160 รายการ ช่วยให้คุณสามารถจัดการและควบคุมอุปกรณ์ Android ได้อย่างละเอียด ครอบคลุมหมวดหมู่ต่างๆ มากกว่าสิบประเภท เช่น การรันคำสั่ง (command execution), การตั้งค่าระบบ (system settings), สถานะระบบ (system status), การจัดการแอปพลิเคชัน (application management), ระบบอัตโนมัติ (automation), พร็อกซี (proxy) และไฟล์ (files) นอกจากนี้ยังมีไลบรารี Python ที่สมบูรณ์แบบเพื่อให้คุณเริ่มต้นใช้งานได้อย่างรวดเร็ว ก่อนที่จะเริ่ม โปรดตรวจสอบให้แน่ใจว่าเซิร์ฟเวอร์ของ FIRERPA ทำงานบนโทรศัพท์ของคุณอย่างถูกต้อง และได้ติดตั้งไลบรารีไคลเอ็นต์ของ FIRERPA ตามข้อกำหนดแล้ว จากนั้นเรามาเริ่มบทแนะนำต่อไปนี้กัน

ข้อควรรู้: API จำนวนมากของ FIRERPA จะคืนค่าเป็นคลาส proto ดั้งเดิม คุณสามารถเข้าถึงค่าต่างๆ ได้โดยตรงผ่าน attribute ของผลลัพธ์ หรือโดยการดูคำจำกัดความของ proto ตัวอย่างเช่น หากผลลัพธ์ที่ได้จาก API เป็นดังนี้ คุณสามารถเข้าถึงฟิลด์ที่ต้องการได้โดยตรงตามตัวอย่าง

>>> result = status.get_battery_info()
>>> print (result)
batt_charging: true
batt_percent: 100
batt_temperature: 26.899999618530273
>>> print (result.batt_temperature)
26.899999618530273

การเชื่อมต่ออุปกรณ์¶

ก่อนที่จะเชื่อมต่ออุปกรณ์ คุณต้องเตรียมข้อมูลที่จำเป็นบางอย่าง เช่น IP address ที่สามารถเชื่อมต่อกับโทรศัพท์ของคุณได้ และตรวจสอบว่าคุณได้ใช้ใบรับรองบริการ (service certificate) ตอนที่เริ่ม FIRERPA หรือไม่ เมื่อเตรียมข้อมูลเหล่านี้พร้อมแล้ว ก็สามารถดำเนินการในขั้นตอนต่อไปได้

สร้าง instance ของอุปกรณ์ โดยปกติแล้วเพียงแค่ระบุ IP address ที่สามารถเข้าถึงได้

from lamda.client import *
d = Device("192.168.0.2")

หากคุณเปิดใช้งานใบรับรองบริการตอนที่เริ่มเซิร์ฟเวอร์ FIRERPA โปรดเชื่อมต่อด้วยวิธีนี้

from lamda.client import *
d = Device("192.168.0.2", certificate="/path/to/lamda.pem")

จากนี้ไป ตัวแปร d ในเอกสารนี้จะหมายถึง instance ของ Device นี้เสมอ

เริ่มต้นง่ายๆ¶

ตอนนี้ ลองรันโค้ดต่อไปนี้ โค้ดบรรทัดนี้จะแสดงข้อความ Hello from Lamda! บนหน้าจอของคุณ

d.show_toast("Hello from Lamda!")

คุณยังสามารถใช้อินเทอร์เฟซต่อไปนี้ ซึ่งจะทำให้อุปกรณ์ส่งเสียงบี๊บ ช่วยให้คุณสามารถระบุตำแหน่งของอุปกรณ์ได้อย่างง่ายดายเมื่อมีอุปกรณ์จำนวนมาก (โทรศัพท์ต้องไม่ได้อยู่ในโหมดเงียบ)

d.beep()

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