Runtime v2.81 · Na-update noong Set 30, 2026

System

I-access ang impormasyon ng system/device ng runtime at mag-trigger ng mga pagkilos sa antas ng system mula sa script.

Syntax

System()

Mga parameter

Wala

Ibinabalik na halaga

System

Pagkilos / epekto

I-access ang impormasyon ng system/device ng runtime at mag-trigger ng mga pagkilos sa antas ng system mula sa script.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

Mga field

PangalanPaglalarawan
devdict
Device capability info (`isEmulator`, `sdk`, `language`, `darkmode`, `touch`, `capture`).
batterydict
Battery info (`percent`, `charging`, `temperature`, `health`).
screendict
Impormasyon ng screen (`width`, `height`, `orientation`, `density`, `dpi`); ang `orientation` ay pag-ikot ng screen sa degrees: `0`, `90`, `180`, o `270`.
memorydict
Memory info (`avail`, `total`, `threshold`, `low`).

Mga method

20 method

System.time_ms

Kunin ang kasalukuyang timestamp sa millisecond.

Syntax

System.time_ms()

Mga parameter

Wala

Ibinabalik na halaga

Number — Epoch millisecond.

Pagkilos / epekto

Kunin ang kasalukuyang timestamp sa millisecond.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
started = System.time_ms()
wait(100)
print(System.time_ms() - started)

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.app_version

Kunin ang pangalan ng bersyon ng app.

Syntax

System.app_version()

Mga parameter

Wala

Ibinabalik na halaga

String — Pangalan ng bersyon ng app.

Pagkilos / epekto

Kunin ang pangalan ng bersyon ng app.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.app_version())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.variant

Kunin ang permanenteng code ng macro variant na pinili para sa run na ito.

Syntax

System.variant()

Mga parameter

Wala

Ibinabalik na halaga

String — Variant code gaya ng `default` o `pro_plus`.

Pagkilos / epekto

Kunin ang permanenteng code ng macro variant na pinili para sa run na ito.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Mag-branch batay sa kasalukuyang macro variant
if System.variant() == "pro_plus":
    print("Pro Plus")

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.open

Buksan ang launchable activity ng naka-install na Android app.

Syntax

System.open(package_name)

Mga parameter

PangalanPaglalarawan
package_nameString
Package name ng Android app, halimbawa `com.android.settings`.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Boolean — `True` kapag tinanggap ng Android ang launch intent; `False` kapag wala ang app, wala itong launchable activity, o hindi ito mabuksan.

Pagkilos / epekto

Buksan ang launchable activity ng naka-install na Android app. Awtomatikong hinahanap ng CogniTab ang karaniwan o Android TV launcher activity mula sa package name, kaya hindi kailangan ang activity class.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Buksan ang Android Settings at pangasiwaan kapag hindi available ang app
opened = System.open("com.android.settings")
if not opened:
    System.toast("App is unavailable")

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.sdk

Kunin ang Android SDK int.

Syntax

System.sdk()

Mga parameter

Wala

Ibinabalik na halaga

Number — Android SDK version integer.

Pagkilos / epekto

Kunin ang Android SDK int.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.sdk())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.language

Kunin ang kasalukuyang code ng wika.

Syntax

System.language()

Mga parameter

Wala

Ibinabalik na halaga

String — Locale language code (halimbawa `en`, `vi`).

Pagkilos / epekto

Kunin ang kasalukuyang code ng wika.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.language())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.dpi

Kumuha ng kasalukuyang screen DPI.

Syntax

System.dpi()

Mga parameter

Wala

Ibinabalik na halaga

Number — Display density DPI.

Pagkilos / epekto

Kumuha ng kasalukuyang screen DPI.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.dpi())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.darkmode

Tingnan kung naka-enable ang dark mode.

Syntax

System.darkmode()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kapag aktibo ang dark mode.

Pagkilos / epekto

Tingnan kung naka-enable ang dark mode.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
if System.darkmode():
    print("Dark mode")

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.play_noti

I-play ang tunog ng notification ng system.

Syntax

System.play_noti()

Mga parameter

Wala

Ibinabalik na halaga

None — Walang return value.

Pagkilos / epekto

I-play ang tunog ng notification ng system.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
System.play_noti()

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.toast

Ipakita ang mensahe ng system toast.

Syntax

System.toast(text)

Mga parameter

PangalanPaglalarawan
textAny
Toast text or structured value to display compactly.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

None — Walang return value.

Pagkilos / epekto

Ipakita ang mensahe ng system toast. Nire-render ang mga structured na value gamit ang compact na DSL display formatter para manatiling maikli at nababasa ang toast.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
System.toast("Macro started")

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.stop

Ihinto kaagad ang kasalukuyang macro mula sa script.

Syntax

System.stop()

Mga parameter

Wala

Ibinabalik na halaga

None — Huminto sa pagpapatupad; walang binabalik na halaga ang sinusunod.

Pagkilos / epekto

Ihinto kaagad ang kasalukuyang macro mula sa script.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Sunod-sunod
  • Sabayang pagpapatakbo: Hindi

Pinahihinto ang buong macro Run, kasama ang background flow. Hindi nagpapatuloy pagkatapos ng tawag; hindi ito API para kanselahin ang isang flow lang.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
if Storage.get("stop_requested", False):
    System.stop()
print("Still running")

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.minimized_dock

I-query o isaayos ang pinaliit na overlay dock.

Syntax

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

Mga parameter

PangalanPaglalarawan
pointPoint?
Optional top-left dock position.
Opsyonal · Ayon sa posisyon o pangalan
Default: None
widthNumber?
Optional minimized dock footprint width in pixels.
Opsyonal · Ayon lang sa pangalan
Default: None
heightNumber?
Optional minimized dock footprint height in pixels.
Opsyonal · Ayon lang sa pangalan
Default: None
alphaNumber?
Optional dock opacity from 0.2 to 1.0.
Opsyonal · Ayon lang sa pangalan
Default: None
modeString?
Opsyonal na presentation ng dock. Mga value: icon o row.
Opsyonal · Ayon lang sa pangalan
Default: None

Ibinabalik na halaga

dict — Inilapat na estado na may `applied`, `x`, `y`, `width`, `height`, `alpha`, `mode`, at opsyonal na `reason`.

Pagkilos / epekto

I-query o isaayos ang pinaliit na overlay dock. Gumagamit ang punto ng parehong sukat ng coordinate at mga panuntunan sa anchor bilang mga target na click na nakabatay sa punto; ang lapad at taas ay kasalukuyang-screen na mga pixel.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Ilipat, baguhin ang laki, at i-collapse ang minimized dock sa icon para sa run na ito
System.minimized_dock(Point(24, 120), width=72, height=36, alpha=0.85, mode="icon")

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.back

Magsagawa ng pandaigdigang pagkilos na Bumalik.

Syntax

System.back()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

Magsagawa ng pandaigdigang pagkilos na Bumalik.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.back())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.home

Magsagawa ng pandaigdigang pagkilos sa Tahanan.

Syntax

System.home()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

Magsagawa ng pandaigdigang pagkilos sa Tahanan.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.home())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.recent

Buksan ang kamakailang screen.

Syntax

System.recent()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

Buksan ang kamakailang screen.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.recent())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.noti

Buksan ang shade ng mga notification.

Syntax

System.noti()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

Buksan ang shade ng mga notification.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.noti())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.lockscreen

I-lock ang kasalukuyang screen.

Syntax

System.lockscreen()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

I-lock ang kasalukuyang screen.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.lockscreen())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.powerdialog

Buksan ang power dialog.

Syntax

System.powerdialog()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

Buksan ang power dialog.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.powerdialog())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.quicksetting

Buksan ang panel ng mga mabilisang setting.

Syntax

System.quicksetting()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

Buksan ang panel ng mga mabilisang setting.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.quicksetting())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

System.screenshot

Mag-trigger ng pandaigdigang pagkilos ng screenshot.

Syntax

System.screenshot()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — `True` kung may ipinadalang aksyon.

Pagkilos / epekto

Mag-trigger ng pandaigdigang pagkilos ng screenshot.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Kumuha ng impormasyon sa Android o humiling ng nakadokumentong system action
print(System.screenshot())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API