Simpan nilai bernama untuk digunakan makro ini pada proses berikutnya. Semua alur dalam satu proses berbagi Storage; variabel biasa hanya dibagikan oleh aksi PYTHON_CODE berurutan dalam satu alur, termasuk GROUP. Alur paralel memiliki variabel terpisah. Storage bukan saluran pesan antarproses.
Sintaks
Storage
Kelas ini tidak dapat dibuat langsung.
Nilai yang dikembalikan
—
Contoh
# Simpan nilai lintas run makro yang terpisah
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))
Metode
8 metode
Storage.get
Static Method
Baca satu nilai yang bertahan berdasarkan kunci dan secara opsional kembali ke default ketika kuncinya hilang.
Sintaks
Storage.get(key, default=None)
Parameter
Nama
Deskripsi
keyAny
Key to look up.
Wajib · Posisi atau nama
Tanpa nilai bawaan
defaultAny?
Fallback value returned when the key is missing.
Opsional · Posisi atau nama
Default:None
Nilai yang dikembalikan
Any? — Nilai yang disimpan untuk kunci tersebut, atau nilai default yang diberikan.
Contoh
# Pulihkan penghitung tersimpan dengan nilai default cadangan
run_count = Storage.get("run_count", 0)
Storage.set
Static Method
Simpan nilai pada sebuah kunci, mengganti nilai lama jika ada. Tipe yang didukung mencakup Number, String, Boolean, Point, Region, list, tuple, dict, set, dan None; koleksi boleh berisi koleksi lain.
Sintaks
Storage.set(key, value)
Parameter
Nama
Deskripsi
keyAny
Key to write.
Wajib · Posisi atau nama
Tanpa nilai bawaan
valueAny?
Value to persist for that key.
Wajib · Posisi atau nama
Tanpa nilai bawaan
Nilai yang dikembalikan
None — Tidak mengembalikan nilai. Pembacaan Storage lain langsung melihat perubahan. Perubahan disimpan ke perangkat setelah 2 detik tanpa penulisan baru dan sekali lagi saat makro serta semua alur latar selesai.
Contoh
# Simpan nilai untuk run makro berikutnya
Storage.set("run_count", 3)
Storage.set("last_point", Point(500, 900))
Storage.remove
Static Method
Hapus satu entri yang bertahan dan kembalikan nilai lama.
Sintaks
Storage.remove(key)
Parameter
Nama
Deskripsi
keyAny
Key to remove.
Wajib · Posisi atau nama
Tanpa nilai bawaan
Nilai yang dikembalikan
Any? — Nilai yang dihapus, atau Tidak Ada saat kuncinya hilang.
Contoh
# Hapus flag tersimpan saat tidak diperlukan lagi
old_flag = Storage.remove("boost_enabled")
Storage.contains
Static Method
Periksa apakah kunci yang ada saat ini ada.
Sintaks
Storage.contains(key)
Parameter
Nama
Deskripsi
keyAny
Key to test.
Wajib · Posisi atau nama
Tanpa nilai bawaan
Nilai yang dikembalikan
Boolean — `True` bila kuncinya ada, jika tidak `False`.
Contoh
# Jalankan penjaga logika berdasarkan state tersimpan
if Storage.contains("last_point"):
MacroPanel.notify("Saved point is ready")
Storage.keys
Static Method
Dapatkan semua kunci yang disimpan sebagai daftar dalam urutan penyisipan.
# Baca semua nilai tersimpan untuk pemeriksaan cepat
saved_values = Storage.values()
Storage.clear
Static Method
Hapus setiap entri yang ada untuk makro saat ini.
Sintaks
Storage.clear()
Nilai yang dikembalikan
None — Tidak ada nilai pengembalian langsung. Penyimpanan menjadi kosong.
Contoh
# Reset semua nilai Storage tersimpan
Storage.clear()
Storage.to_dict
Static Method
Ambil dict yang digunakan Storage dalam proses ini. Semua alur berbagi dict tersebut: menambah, mengubah, atau menghapus entri langsung mengubah Storage. Edit disimpan setelah 2 detik tanpa penulisan baru dan sekali lagi saat makro serta semua alur latar selesai.
Sintaks
Storage.to_dict()
Nilai yang dikembalikan
dict — Dict Storage itu sendiri, bukan salinan terpisah.
Contoh
# Baca dan perbarui seluruh dictionary storage tersimpan
state = Storage.to_dict()
state["bonus"] = 5
MacroPanel.notify(str(state))