System

Truy cập thông tin hệ thống/thiết bị và gọi hành động hệ thống từ script.

Cú pháp

System()

Giá trị trả về

Ví dụ

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

Thuộc tính

TênMô tả
devdict
Thông tin thiết bị hiện tại: isEmulator, cấp API Android sdk, mã language, darkmode, khả năng touch và trạng thái sẵn sàng capture. Đọc lại để lấy thông tin mới.
batterydict
Thông tin pin hiện tại: percent từ 0 đến 100, charging, temperature theo độ C và health dạng chữ. percent hoặc temperature không đọc được là -1; health không rõ là "unknown". Đọc lại để cập nhật.
screendict
Thông tin màn hình hiện tại: width và height theo pixel, hệ số density, dpi và orientation là góc xoay màn hình theo độ (0, 90, 180 hoặc 270). Đọc lại sau khi xoay thiết bị.
memorydict
Bộ nhớ hệ thống hiện tại: avail, total và ngưỡng thiếu bộ nhớ threshold tính theo byte; low cho biết bộ nhớ khả dụng đang thấp. Đọc lại để cập nhật.

Phương thức

21 phương thức

System.time_ms

Đọc ngày giờ hiện tại dưới dạng số mili giây kể từ 00:00:00 UTC ngày 01/01/1970.

Cú pháp

System.time_ms()

Giá trị trả về

Number — Số mili giây kể từ 00:00:00 UTC ngày 01/01/1970.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
started = System.time_ms()
wait(100)
print(System.time_ms() - started)

System.app_version

Đọc tên phiên bản CogniTab đang cài đặt.

Cú pháp

System.app_version()

Giá trị trả về

String — Tên phiên bản CogniTab, hoặc "unknown" nếu không đọc được.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.app_version())

System.variant

Lấy mã ổn định của biến thể macro được chọn cho lần chạy này.

Cú pháp

System.variant()

Giá trị trả về

String — Mã biến thể, ví dụ `default` hoặc `pro_plus`.

Ví dụ

# Rẽ nhánh theo biến thể macro hiện tại
if System.variant() == "pro_plus":
    print("Pro Plus")

System.open

Mở activity khởi chạy của một ứng dụng Android đã cài đặt. CogniTab tự tìm launcher activity thông thường hoặc Android TV từ package name nên không cần truyền tên lớp activity.

Cú pháp

System.open(package_name)

Tham số

TênMô tả
package_nameString
Package name của ứng dụng Android, ví dụ `com.android.settings`.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean — `True` khi Android chấp nhận intent mở ứng dụng; `False` khi ứng dụng không có sẵn, không có activity có thể khởi chạy hoặc không thể mở.

Ví dụ

# Mở Cài đặt Android và xử lý khi ứng dụng không khả dụng
opened = System.open("com.android.settings")
if not opened:
    System.toast("App is unavailable")

System.sdk

Đọc cấp API Android mà thiết bị đang sử dụng.

Cú pháp

System.sdk()

Giá trị trả về

Number — Cấp API Android dưới dạng số.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.sdk())

System.language

Lấy mã ngôn ngữ hiện tại.

Cú pháp

System.language()

Giá trị trả về

String — Mã ngôn ngữ locale (ví dụ `en`, `vi`).

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.language())

System.dpi

Lấy DPI hiện tại của màn hình.

Cú pháp

System.dpi()

Giá trị trả về

Number — Mật độ hiển thị DPI.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.dpi())

System.darkmode

Kiểm tra dark mode có đang bật hay không.

Cú pháp

System.darkmode()

Giá trị trả về

Boolean — `True` khi dark mode đang bật.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
if System.darkmode():
    print("Dark mode")

System.play_noti

Phát âm thanh thông báo hệ thống.

Cú pháp

System.play_noti()

Giá trị trả về

None — Không có giá trị trả về.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
System.play_noti()

System.toast

Hiện thông báo ngắn của Android. List, dict và các giá trị có cấu trúc khác được trình bày gọn để dễ đọc.

Cú pháp

System.toast(text)

Tham số

TênMô tả
textAny
Chuỗi toast hoặc giá trị có cấu trúc cần hiển thị ở dạng gọn.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

None — Không có giá trị trả về.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
System.toast("Macro started")

System.stop

Dừng macro hiện tại ngay từ script.

Cú pháp

System.stop()

Giá trị trả về

None — Dừng thực thi; không có giá trị trả về được quan sát.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
if Storage.get("stop_requested", False):
    System.stop()
print("Still running")

System.minimized_dock

Xem hoặc điều chỉnh dock thu nhỏ của lớp phủ. Point dùng cùng quy tắc scale và neo toạ độ với các điểm click dạng Point; width và height là pixel trên màn hình hiện tại.

Cú pháp

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

Tham số

TênMô tả
pointPoint?
Vị trí góc trên trái tuỳ chọn của dock.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None
widthNumber?
Độ rộng vùng dock thu nhỏ tùy chọn, tính bằng pixel. Khi có bảng nổi thu nhỏ gắn vào, dock dùng kích thước tự nhiên; kích thước yêu cầu được giữ lại và áp dụng lại khi không còn bảng gắn vào.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
heightNumber?
Độ cao vùng dock thu nhỏ tùy chọn, tính bằng pixel. Khi có bảng nổi thu nhỏ gắn vào, dock dùng kích thước tự nhiên; kích thước yêu cầu được giữ lại và áp dụng lại khi không còn bảng gắn vào.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
alphaNumber?
Độ mờ tuỳ chọn của dock từ 0.2 đến 1.0.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
modeString?
Kiểu hiển thị dock tùy chọn: icon, row hoặc hidden. icon giữ nút mở bảng nổi đang thu nhỏ. hidden có hiệu lực trong lượt chạy và giữ nút Dừng ở góc dưới trái khi không có nút Dừng trên bảng nổi đang hiển thị; khi bảng thu nhỏ, cửa sổ khẩn cấp này cũng có nút mở bảng.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None

Giá trị trả về

dict — Trạng thái đã áp dụng gồm `applied`, `x`, `y`, `width`, `height`, `alpha`, `mode`, và `reason` nếu có.

Ví dụ

# Di chuyển, đổi kích thước và thu dock thu nhỏ thành một icon cho lượt chạy này
System.minimized_dock(Point(24, 120), width=72, height=36, alpha=0.85, mode="icon")

System.send_key

Gửi một cặp sự kiện nhấn/nhả phím Android tới ô nhập đang có focus qua Accessibility trên Android 13 trở lên. Gửi sự kiện phím mà không cần tìm vị trí phím trên bàn phím ảo.

Cú pháp

System.send_key(key)

Tham số

TênMô tả
keyString|Number
Tên phím Android không phân biệt hoa thường, có thể thêm tiền tố `KEYCODE_`, ví dụ `ENTER`, `TAB`, `ESCAPE`, `DEL`, `DPAD_LEFT`, `A` hoặc `F1`; hoặc mã phím Android là số nguyên dương, ví dụ `66` cho Enter. Khoảng trắng ở đầu/cuối tên phím được bỏ qua.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean — `True` khi đã gửi cả hai sự kiện phím; `False` trên Android 12L trở xuống, khi phím không được hỗ trợ, không có kết nối tới ô nhập đang hoạt động hoặc gửi phím thất bại. Ứng dụng đích quyết định cách xử lý phím; cần kiểm tra màn hình trước khi tiếp tục. Hàm không gửi phím phần cứng tới toàn hệ thống và không xác nhận ứng dụng đã xử lý phím.

Ví dụ

# Gửi phím tới ô nhập đang có focus bằng tên hoặc mã phím Android
sent = System.send_key("ENTER")
System.send_key(key="TAB")
System.send_key(66)

System.back

Yêu cầu Android quay lại, tương tự nhấn nút Back.

Cú pháp

System.back()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.back())

System.home

Yêu cầu Android mở màn hình chính.

Cú pháp

System.home()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.home())

System.recent

Mở màn hình ứng dụng gần đây.

Cú pháp

System.recent()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.recent())

System.noti

Mở vùng thông báo.

Cú pháp

System.noti()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.noti())

System.lockscreen

Khóa màn hình hiện tại.

Cú pháp

System.lockscreen()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.lockscreen())

System.powerdialog

Mở hộp thoại nguồn.

Cú pháp

System.powerdialog()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.powerdialog())

System.quicksetting

Mở bảng cài đặt nhanh của Android.

Cú pháp

System.quicksetting()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.quicksetting())

System.screenshot

Yêu cầu Android chụp ảnh màn hình.

Cú pháp

System.screenshot()

Giá trị trả về

Boolean — `True` nếu Android chấp nhận thao tác, ngược lại là `False`.

Ví dụ

# Đọc thông tin Android hoặc yêu cầu một thao tác hệ thống đã được hỗ trợ
print(System.screenshot())