อ่านค่าที่คงอยู่หนึ่งค่าตามคีย์และเลือกที่จะถอยกลับไปเป็นค่าเริ่มต้นเมื่อคีย์หายไป
รูปแบบคำสั่ง
Storage.get(key, default=None)
ค่าที่ส่งกลับ
Any? — ค่าที่เก็บไว้สำหรับคีย์นั้น หรือค่าเริ่มต้นที่ให้ไว้
ตัวอย่าง
# กู้คืนตัวนับที่บันทึกไว้พร้อมค่าเริ่มต้นสำรอง
run_count = Storage.get("run_count", 0)
บันทึกค่าตามคีย์ โดยแทนค่าเดิมหากมี รองรับ Number, String, Boolean, Point, Region, list, tuple, dict, set และ None และเก็บคอลเลกชันซ้อนกันได้
ค่าที่ส่งกลับ
None — ไม่มีค่าคืน การอ่าน Storage อื่นเห็นการเปลี่ยนแปลงทันที บันทึกลงอุปกรณ์เมื่อไม่มีการเขียนใหม่เป็นเวลา 2 วินาที และบันทึกอีกครั้งเมื่อมาโครกับโฟลว์เบื้องหลังทั้งหมดจบตัวอย่าง
# บันทึกค่าสำหรับการรัน macro ครั้งถัดไป
Storage.set("run_count", 3)
Storage.set("last_point", Point(500, 900))
ลบหนึ่งรายการที่มีอยู่และส่งกลับค่าเก่า
ค่าที่ส่งกลับ
Any? — ค่าที่ถูกลบออก หรือไม่มีเมื่อคีย์หายไป
ตัวอย่าง
# ลบ flag ที่บันทึกไว้เมื่อไม่ต้องใช้แล้ว
old_flag = Storage.remove("boost_enabled")
ตรวจสอบว่ามีคีย์ที่มีอยู่ในปัจจุบันหรือไม่
ค่าที่ส่งกลับ
Boolean — "จริง" เมื่อมีคีย์อยู่ มิฉะนั้นจะเป็น "เท็จ"
ตัวอย่าง
# คุม logic ตาม state ที่บันทึกไว้
if Storage.contains("last_point"):
MacroPanel.notify("Saved point is ready")
รับคีย์ที่มีอยู่ทั้งหมดเป็นรายการตามลำดับการแทรก
ค่าที่ส่งกลับ
list — รายการคีย์ที่มีอยู่ตัวอย่าง
# ตรวจดูว่าค่าใดถูกบันทึกไว้สำหรับ macro นี้
saved_keys = Storage.keys()
รับค่าที่มีอยู่ทั้งหมดเป็นรายการตามลำดับการแทรก
ค่าที่ส่งกลับ
list — รายการค่าที่มีอยู่ตัวอย่าง
# อ่านค่าที่บันทึกไว้ทั้งหมดเพื่อตรวจสอบอย่างรวดเร็ว
saved_values = Storage.values()
ลบทุกรายการที่มีอยู่สำหรับแมโครปัจจุบัน
ค่าที่ส่งกลับ
None — ไม่มีค่าตอบแทนโดยตรง ที่เก็บข้อมูลว่างเปล่า
ตัวอย่าง
# รีเซ็ตค่า Storage ที่บันทึกไว้ทั้งหมด
Storage.clear()
รับ dict ที่ Storage ใช้ในการรันนี้ ทุกโฟลว์ใช้ร่วมกัน การเพิ่ม แก้ไข หรือลบรายการเปลี่ยน Storage ทันที บันทึกการแก้ไขเมื่อไม่มีการเขียนใหม่ 2 วินาที และอีกครั้งเมื่อมาโครกับโฟลว์เบื้องหลังทั้งหมดจบ
ตัวอย่าง
# อ่านและอัปเดต dictionary storage ที่บันทึกไว้ทั้งหมด
state = Storage.to_dict()
state["bonus"] = 5
MacroPanel.notify(str(state))