System

Akses info sistem/perangkat runtime dan picu tindakan tingkat sistem dari skrip.

Sintaks

System()

Nilai yang dikembalikan

Contoh

sys = System()
print("sdk=", sys.sdk())
battery = System.battery()
print("battery=", battery.percent, battery.charging)
System.toast("Macro started")
System.play_noti()
System.home()

Field

NamaDeskripsi
devdict
Detail perangkat saat ini: isEmulator, level API Android sdk, kode language, darkmode, dukungan touch, dan kesiapan capture. Baca lagi untuk mendapatkan detail terbaru.
batterydict
Detail baterai saat ini: percent dari 0 hingga 100, charging, temperature dalam derajat Celsius, dan teks health. percent atau temperature yang tidak tersedia bernilai -1; health yang tidak diketahui adalah "unknown". Baca lagi untuk memperbarui.
screendict
Detail layar saat ini: width dan height dalam piksel, skala density, dpi, serta orientation sebagai rotasi layar dalam derajat (0, 90, 180, atau 270). Baca lagi setelah memutar perangkat.
memorydict
Memori sistem saat ini: avail, total, dan ambang memori rendah threshold dalam byte; low menunjukkan memori tersedia sedikit. Baca lagi untuk memperbarui.

Metode

21 metode

System.time_ms

Baca tanggal dan waktu saat ini dalam milidetik sejak 1970-01-01 00:00:00 UTC.

Sintaks

System.time_ms()

Nilai yang dikembalikan

Number — Milidetik sejak 1970-01-01 00:00:00 UTC.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
started = System.time_ms()
wait(100)
print(System.time_ms() - started)

System.app_version

Baca nama versi CogniTab yang terpasang.

Sintaks

System.app_version()

Nilai yang dikembalikan

String — Nama versi CogniTab, atau "unknown" jika tidak tersedia.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.app_version())

System.variant

Dapatkan kode stabil varian macro yang dipilih untuk eksekusi ini.

Sintaks

System.variant()

Nilai yang dikembalikan

String — Kode varian seperti `default` atau `pro_plus`.

Contoh

# Buat percabangan berdasarkan varian macro saat ini
if System.variant() == "pro_plus":
    print("Pro Plus")

System.open

Buka aktivitas peluncur aplikasi Android yang terinstal. CogniTab menemukan aktivitas peluncur standar atau Android TV dari nama paket, sehingga kelas aktivitas tidak perlu diberikan.

Sintaks

System.open(package_name)

Parameter

NamaDeskripsi
package_nameString
Nama paket aplikasi Android, misalnya `com.android.settings`.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Boolean — `True` saat Android menerima intent peluncuran; `False` saat aplikasi tidak tersedia, tidak memiliki aktivitas yang dapat diluncurkan, atau tidak dapat dibuka.

Contoh

# Buka Setelan Android dan tangani jika aplikasi tidak tersedia
opened = System.open("com.android.settings")
if not opened:
    System.toast("App is unavailable")

System.sdk

Baca level API Android yang digunakan perangkat ini.

Sintaks

System.sdk()

Nilai yang dikembalikan

Number — Level API Android berupa angka.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.sdk())

System.language

Dapatkan kode bahasa saat ini.

Sintaks

System.language()

Nilai yang dikembalikan

String — Kode bahasa lokal (misalnya `en`, `vi`).

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.language())

System.dpi

Dapatkan DPI layar saat ini.

Sintaks

System.dpi()

Nilai yang dikembalikan

Number — DPI kepadatan tampilan.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.dpi())

System.darkmode

Periksa apakah mode gelap diaktifkan.

Sintaks

System.darkmode()

Nilai yang dikembalikan

Boolean — `Benar` saat mode gelap aktif.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
if System.darkmode():
    print("Dark mode")

System.play_noti

Putar suara notifikasi sistem.

Sintaks

System.play_noti()

Nilai yang dikembalikan

None — Tidak ada nilai kembalian.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
System.play_noti()

System.toast

Tampilkan pesan singkat Android. List, dict, dan nilai terstruktur lain diringkas agar mudah dibaca.

Sintaks

System.toast(text)

Parameter

NamaDeskripsi
textAny
Toast text or structured value to display compactly.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai kembalian.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
System.toast("Macro started")

System.stop

Segera hentikan makro saat ini dari skrip.

Sintaks

System.stop()

Nilai yang dikembalikan

None — Menghentikan eksekusi; tidak ada nilai kembalian yang diamati.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
if Storage.get("stop_requested", False):
    System.stop()
print("Still running")

System.minimized_dock

Kueri atau sesuaikan dok overlay yang diperkecil. Titik tersebut menggunakan skala koordinat dan aturan jangkar yang sama dengan target klik berbasis titik; lebar dan tinggi adalah piksel layar saat ini.

Sintaks

System.minimized_dock(point=None, *, width=None, height=None, alpha=None, mode=None)

Parameter

NamaDeskripsi
pointPoint?
Optional top-left dock position.
Opsional · Posisi atau nama
Default: None
widthNumber?
Lebar area dock yang diciutkan dalam piksel. Saat panel mengambang yang diciutkan terpasang, dock menggunakan ukuran alaminya; ukuran yang diminta disimpan dan diterapkan kembali saat panel tidak lagi terpasang.
Opsional · Hanya nama
Default: None
heightNumber?
Tinggi area dock yang diciutkan dalam piksel. Saat panel mengambang yang diciutkan terpasang, dock menggunakan ukuran alaminya; ukuran yang diminta disimpan dan diterapkan kembali saat panel tidak lagi terpasang.
Opsional · Hanya nama
Default: None
alphaNumber?
Optional dock opacity from 0.2 to 1.0.
Opsional · Hanya nama
Default: None
modeString?
Tampilan dock opsional: icon, row, atau hidden. icon tetap menyediakan tombol buka untuk panel mengambang yang diciutkan. hidden berlaku selama proses ini dan mempertahankan tombol Berhenti di kiri bawah saat tidak ada tombol Berhenti pada panel mengambang yang terlihat; saat panel diciutkan, jendela darurat ini juga menyediakan tombol buka.
Opsional · Hanya nama
Default: None

Nilai yang dikembalikan

dict — Status yang diterapkan dengan `applied`, `x`, `y`, `width`, `height`, `alpha`, `mode`, dan `reason` opsional.

Contoh

# Pindahkan, ubah ukuran, dan ciutkan dock kecil menjadi ikon untuk run ini
System.minimized_dock(Point(24, 120), width=72, height=36, alpha=0.85, mode="icon")

System.send_key

Kirim sepasang peristiwa tekan dan lepas tombol Android ke editor teks yang sedang aktif melalui Accessibility di Android 13 atau lebih baru, tanpa mencari posisi tombol pada keyboard layar.

Sintaks

System.send_key(key)

Parameter

NamaDeskripsi
keyString|Number
Nama tombol Android tanpa membedakan huruf besar dan kecil, dengan awalan `KEYCODE_` opsional, misalnya `ENTER`, `TAB`, `ESCAPE`, `DEL`, `DPAD_LEFT`, `A`, atau `F1`; atau kode tombol Android berupa bilangan bulat positif, misalnya `66` untuk Enter. Spasi di awal dan akhir nama diabaikan.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Boolean — `True` jika kedua peristiwa tombol sudah dikirim; `False` di Android 12L atau lebih lama, jika tombol tidak didukung, tidak ada koneksi input editor yang aktif, atau pengiriman gagal. Aplikasi tujuan menentukan cara menangani tombol; periksa layarnya sebelum melanjutkan. Fungsi ini tidak mengirim tombol perangkat keras ke seluruh sistem atau memastikan bahwa aplikasi telah menanganinya.

Contoh

# Kirim tombol ke kolom teks yang sedang aktif dengan nama atau kode tombol Android
sent = System.send_key("ENTER")
System.send_key(key="TAB")
System.send_key(66)

System.back

Minta Android kembali, seperti menekan tombol Back.

Sintaks

System.back()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.back())

System.home

Minta Android membuka layar utama.

Sintaks

System.home()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.home())

System.recent

Buka layar terkini.

Sintaks

System.recent()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.recent())

System.noti

Buka bayangan notifikasi.

Sintaks

System.noti()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.noti())

System.lockscreen

Kunci layar saat ini.

Sintaks

System.lockscreen()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.lockscreen())

System.powerdialog

Buka dialog kekuasaan.

Sintaks

System.powerdialog()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.powerdialog())

System.quicksetting

Buka pengaturan cepat Android.

Sintaks

System.quicksetting()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.quicksetting())

System.screenshot

Minta Android mengambil tangkapan layar.

Sintaks

System.screenshot()

Nilai yang dikembalikan

Boolean — `True` jika Android menerima tindakan, selain itu `False`.

Contoh

# Ambil informasi Android atau minta tindakan sistem yang terdokumentasi
print(System.screenshot())