Storage

บันทึกค่าตามชื่อให้มาโครปัจจุบันใช้ในการรันครั้งต่อไป ทุกโฟลว์ในการรันเดียวกันใช้ Storage ร่วมกัน ตัวแปรปกติใช้ร่วมเฉพาะแอ็กชัน PYTHON_CODE ที่ทำตามลำดับในโฟลว์เดียว รวมถึงใน GROUP โฟลว์ขนานมีตัวแปรแยกกัน Storage ไม่ใช่ช่องส่งข้อความระหว่างโปรเซส

รูปแบบคำสั่ง

Storage

ไม่สามารถสร้างคลาสนี้โดยตรงได้

ค่าที่ส่งกลับ

—

ตัวอย่าง

# บันทึกค่าให้ใช้ข้ามการรัน macro คนละครั้ง
run_count = Storage.get("run_count", 0)
run_count = run_count + 1
Storage.set("run_count", run_count)
Storage.set("last_point", Point(500, 900))
MacroPanel.notify("Run #" + str(run_count))

เมธอด

8 เมธอด

Storage.get

อ่านค่าที่คงอยู่หนึ่งค่าตามคีย์และเลือกที่จะถอยกลับไปเป็นค่าเริ่มต้นเมื่อคีย์หายไป

รูปแบบคำสั่ง

Storage.get(key, default=None)

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Key to look up.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
defaultAny?
Fallback value returned when the key is missing.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

Any? — ค่าที่เก็บไว้สำหรับคีย์นั้น หรือค่าเริ่มต้นที่ให้ไว้

ตัวอย่าง

# กู้คืนตัวนับที่บันทึกไว้พร้อมค่าเริ่มต้นสำรอง
run_count = Storage.get("run_count", 0)

Storage.set

บันทึกค่าตามคีย์ โดยแทนค่าเดิมหากมี รองรับ Number, String, Boolean, Point, Region, list, tuple, dict, set และ None และเก็บคอลเลกชันซ้อนกันได้

รูปแบบคำสั่ง

Storage.set(key, value)

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Key to write.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
valueAny?
Value to persist for that key.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

None — ไม่มีค่าคืน การอ่าน Storage อื่นเห็นการเปลี่ยนแปลงทันที บันทึกลงอุปกรณ์เมื่อไม่มีการเขียนใหม่เป็นเวลา 2 วินาที และบันทึกอีกครั้งเมื่อมาโครกับโฟลว์เบื้องหลังทั้งหมดจบ

ตัวอย่าง

# บันทึกค่าสำหรับการรัน macro ครั้งถัดไป
Storage.set("run_count", 3)
Storage.set("last_point", Point(500, 900))

Storage.remove

ลบหนึ่งรายการที่มีอยู่และส่งกลับค่าเก่า

รูปแบบคำสั่ง

Storage.remove(key)

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Key to remove.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Any? — ค่าที่ถูกลบออก หรือไม่มีเมื่อคีย์หายไป

ตัวอย่าง

# ลบ flag ที่บันทึกไว้เมื่อไม่ต้องใช้แล้ว
old_flag = Storage.remove("boost_enabled")

Storage.contains

ตรวจสอบว่ามีคีย์ที่มีอยู่ในปัจจุบันหรือไม่

รูปแบบคำสั่ง

Storage.contains(key)

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Key to test.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Boolean — "จริง" เมื่อมีคีย์อยู่ มิฉะนั้นจะเป็น "เท็จ"

ตัวอย่าง

# คุม logic ตาม state ที่บันทึกไว้
if Storage.contains("last_point"):
    MacroPanel.notify("Saved point is ready")

Storage.keys

รับคีย์ที่มีอยู่ทั้งหมดเป็นรายการตามลำดับการแทรก

รูปแบบคำสั่ง

Storage.keys()

ค่าที่ส่งกลับ

list — รายการคีย์ที่มีอยู่

ตัวอย่าง

# ตรวจดูว่าค่าใดถูกบันทึกไว้สำหรับ macro นี้
saved_keys = Storage.keys()

Storage.values

รับค่าที่มีอยู่ทั้งหมดเป็นรายการตามลำดับการแทรก

รูปแบบคำสั่ง

Storage.values()

ค่าที่ส่งกลับ

list — รายการค่าที่มีอยู่

ตัวอย่าง

# อ่านค่าที่บันทึกไว้ทั้งหมดเพื่อตรวจสอบอย่างรวดเร็ว
saved_values = Storage.values()

Storage.clear

ลบทุกรายการที่มีอยู่สำหรับแมโครปัจจุบัน

รูปแบบคำสั่ง

Storage.clear()

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง ที่เก็บข้อมูลว่างเปล่า

ตัวอย่าง

# รีเซ็ตค่า Storage ที่บันทึกไว้ทั้งหมด
Storage.clear()

Storage.to_dict

รับ dict ที่ Storage ใช้ในการรันนี้ ทุกโฟลว์ใช้ร่วมกัน การเพิ่ม แก้ไข หรือลบรายการเปลี่ยน Storage ทันที บันทึกการแก้ไขเมื่อไม่มีการเขียนใหม่ 2 วินาที และอีกครั้งเมื่อมาโครกับโฟลว์เบื้องหลังทั้งหมดจบ

รูปแบบคำสั่ง

Storage.to_dict()

ค่าที่ส่งกลับ

dict — dict ของ Storage โดยตรง ไม่ใช่สำเนาแยก

ตัวอย่าง

# อ่านและอัปเดต dictionary storage ที่บันทึกไว้ทั้งหมด
state = Storage.to_dict()
state["bonus"] = 5
MacroPanel.notify(str(state))