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()
Tham số
Không có
Giá trị trả về
System
Hành vi / tác động
Truy cập thông tin hệ thống/thiết bị và gọi hành động hệ thống từ script.
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
API liên quan
Không có
Thuộc tính
Tên
Mô tả
devdict
Thông tin khả năng thiết bị (`isEmulator`, `sdk`, `language`, `darkmode`, `touch`, `capture`).
batterydict
Thông tin pin (`percent`, `charging`, `temperature`, `health`).
screendict
Thông tin màn hình (`width`, `height`, `orientation`, `density`, `dpi`); `orientation` là góc xoay màn hình theo độ: `0`, `90`, `180` hoặc `270`.
memorydict
Thông tin bộ nhớ (`avail`, `total`, `threshold`, `low`).
Phương thức
20 phương thức
System.time_ms
Static Method
Lấy timestamp hiện tại theo mili giây.
Cú pháp
System.time_ms()
Tham số
Không có
Giá trị trả về
Number — Epoch mili giây.
Hành vi / tác động
Lấy timestamp hiện tại theo mili giây.
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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)
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
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()
Tham số
Không có
Giá trị trả về
String — Mã biến thể, ví dụ `default` hoặc `pro_plus`.
Hành vi / tác động
Lấy mã ổn định của biến thể macro được chọn cho lần chạy này.
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
Ví dụ
# Rẽ nhánh theo biến thể macro hiện tại
if System.variant() == "pro_plus":
print("Pro Plus")
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Mở activity khởi chạy của một ứng dụng Android đã cài đặt.
Cú pháp
System.open(package_name)
Tham số
Tên
Mô 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ở.
Hành vi / tác động
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.
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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")
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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")
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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()
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
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ề.
Hành vi / tác động
Hiển thị toast hệ thống. Giá trị có cấu trúc sẽ được render bằng formatter DSL bản gọn để toast vẫn ngắn và dễ đọc.
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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")
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
None — Dừng thực thi; không có giá trị trả về được quan sát.
Hành vi / tác động
Dừng macro hiện tại ngay từ script.
Thực thi
Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Thực hiện tuần tự
Chạy song song: Không
Dừng toàn bộ lượt Run của macro, gồm luồng nền. Không tiếp tục thực thi sau lời gọi; đây không phải API hủy riêng một luồng.
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")
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Độ rộng vùng dock thu nhỏ tuỳ chọn, tính bằng pixel.
Tùy chọn · Chỉ truyền theo tên
Mặc định:None
heightNumber?
Độ cao vùng dock thu nhỏ tuỳ chọn, tính bằng pixel.
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 tuỳ chọn. Giá trị: icon hoặc row.
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ó.
Hành vi / tác động
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.
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Không bảo đảm
Chạy song song: Tùy điều kiện
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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")
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.
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())
Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.
