Runtime v2.81 · Diperbarui 30 Sep 2026

System

Class

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

Sintaks

System()

Parameter

Tidak ada

Nilai yang dikembalikan

System

Perilaku / efek samping

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

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Tidak ada

Field

Nama	Deskripsi
`devdict`	Device capability info (`isEmulator`, `sdk`, `language`, `darkmode`, `touch`, `capture`).
`batterydict`	Battery info (`percent`, `charging`, `temperature`, `health`).
`screendict`	Info layar (`width`, `height`, `orientation`, `density`, `dpi`); `orientation` adalah rotasi layar dalam derajat: `0`, `90`, `180`, atau `270`.
`memorydict`	Memory info (`avail`, `total`, `threshold`, `low`).

Metode

20 metode

System.time_ms

Static Method

Dapatkan stempel waktu saat ini dalam milidetik.

Sintaks

System.time_ms()

Parameter

Tidak ada

Nilai yang dikembalikan

Number — Epoch milidetik.

Perilaku / efek samping

Dapatkan stempel waktu saat ini dalam milidetik.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.app_version

Static Method

Dapatkan nama versi aplikasi.

Sintaks

System.app_version()

Parameter

Tidak ada

Nilai yang dikembalikan

String — Nama versi aplikasi.

Perilaku / efek samping

Dapatkan nama versi aplikasi.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.variant

Static Method

Dapatkan kode stabil varian macro yang dipilih untuk eksekusi ini.

Sintaks

System.variant()

Parameter

Tidak ada

Nilai yang dikembalikan

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

Perilaku / efek samping

Dapatkan kode stabil varian macro yang dipilih untuk eksekusi ini.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.open

Static Method

Buka aktivitas peluncur aplikasi Android yang terinstal.

Sintaks

System.open(package_name)

Parameter

Nama	Deskripsi
`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.

Perilaku / efek samping

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

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.sdk

Static Method

Dapatkan Android SDK int.

Sintaks

System.sdk()

Parameter

Tidak ada

Nilai yang dikembalikan

Number — Bilangan bulat versi SDK Android.

Perilaku / efek samping

Dapatkan Android SDK int.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.language

Static Method

Dapatkan kode bahasa saat ini.

Sintaks

System.language()

Parameter

Tidak ada

Nilai yang dikembalikan

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

Perilaku / efek samping

Dapatkan kode bahasa saat ini.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.dpi

Static Method

Dapatkan DPI layar saat ini.

Sintaks

System.dpi()

Parameter

Tidak ada

Nilai yang dikembalikan

Number — DPI kepadatan tampilan.

Perilaku / efek samping

Dapatkan DPI layar saat ini.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.darkmode

Static Method

Periksa apakah mode gelap diaktifkan.

Sintaks

System.darkmode()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` saat mode gelap aktif.

Perilaku / efek samping

Periksa apakah mode gelap diaktifkan.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.play_noti

Static Method

Putar suara notifikasi sistem.

Sintaks

System.play_noti()

Parameter

Tidak ada

Nilai yang dikembalikan

None — Tidak ada nilai kembalian.

Perilaku / efek samping

Putar suara notifikasi sistem.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.toast

Static Method

Tampilkan pesan roti panggang sistem.

Sintaks

System.toast(text)

Parameter

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

Nilai yang dikembalikan

None — Tidak ada nilai kembalian.

Perilaku / efek samping

Tampilkan pesan roti panggang sistem. Nilai terstruktur dirender dengan formatter tampilan DSL ringkas sehingga hasil tetap singkat dan mudah dibaca.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.stop

Static Method

Segera hentikan makro saat ini dari skrip.

Sintaks

System.stop()

Parameter

Tidak ada

Nilai yang dikembalikan

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

Perilaku / efek samping

Segera hentikan makro saat ini dari skrip.

Eksekusi

Menunggu selesai: Tidak
Keamanan akses bersamaan: Dijalankan berurutan
Eksekusi paralel: Tidak

Menghentikan seluruh Run makro, termasuk alur latar. Eksekusi tidak berlanjut setelah panggilan; ini bukan API pembatalan per alur.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System.minimized_dock

Static Method

Kueri atau sesuaikan dok overlay yang diperkecil.

Sintaks

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

Parameter

Nama	Deskripsi
`pointPoint?`	Optional top-left dock position. Opsional · Posisi atau nama Default: `None`
`widthNumber?`	Optional minimized dock footprint width in pixels. Opsional · Hanya nama Default: `None`
`heightNumber?`	Optional minimized dock footprint height in pixels. Opsional · Hanya nama Default: `None`
`alphaNumber?`	Optional dock opacity from 0.2 to 1.0. Opsional · Hanya nama Default: `None`
`modeString?`	Tampilan dock opsional. Nilai: icon atau row. Opsional · Hanya nama Default: `None`

Nilai yang dikembalikan

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

Perilaku / efek samping

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.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.back

Static Method

Lakukan tindakan Kembali global.

Sintaks

System.back()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Lakukan tindakan Kembali global.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.home

Static Method

Lakukan tindakan Beranda global.

Sintaks

System.home()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Lakukan tindakan Beranda global.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.recent

Static Method

Buka layar terkini.

Sintaks

System.recent()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Buka layar terkini.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.noti

Static Method

Buka bayangan notifikasi.

Sintaks

System.noti()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Buka bayangan notifikasi.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.lockscreen

Static Method

Kunci layar saat ini.

Sintaks

System.lockscreen()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Kunci layar saat ini.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.powerdialog

Static Method

Buka dialog kekuasaan.

Sintaks

System.powerdialog()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Buka dialog kekuasaan.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.quicksetting

Static Method

Buka panel pengaturan cepat.

Sintaks

System.quicksetting()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Buka panel pengaturan cepat.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System

System.screenshot

Static Method

Memicu tindakan tangkapan layar global.

Sintaks

System.screenshot()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — `Benar` jika tindakan dikirim.

Perilaku / efek samping

Memicu tindakan tangkapan layar global.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Tidak dijamin
Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

System