Storage

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

Baca satu nilai yang bertahan berdasarkan kunci dan secara opsional kembali ke default ketika kuncinya hilang.

Sintaks

Storage.get(key, default=None)

Parameter

NamaDeskripsi
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

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

NamaDeskripsi
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

Hapus satu entri yang bertahan dan kembalikan nilai lama.

Sintaks

Storage.remove(key)

Parameter

NamaDeskripsi
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

Periksa apakah kunci yang ada saat ini ada.

Sintaks

Storage.contains(key)

Parameter

NamaDeskripsi
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

Dapatkan semua kunci yang disimpan sebagai daftar dalam urutan penyisipan.

Sintaks

Storage.keys()

Nilai yang dikembalikan

list — Daftar kunci yang disimpan.

Contoh

# Periksa nilai mana yang tersimpan untuk makro ini
saved_keys = Storage.keys()

Storage.values

Dapatkan semua nilai yang bertahan sebagai daftar dalam urutan penyisipan.

Sintaks

Storage.values()

Nilai yang dikembalikan

list — Daftar nilai yang bertahan.

Contoh

# Baca semua nilai tersimpan untuk pemeriksaan cepat
saved_values = Storage.values()

Storage.clear

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

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))