Unison Engine API

Appearance

unison.excore — 引擎核心 ​

引擎级别的核心接口，包括窗口管理、帧率控制、消息框等。

使用方式 ​

python
from unison import excore

函数列表 ​

log_info(text) ​

log_warning(text) ​

输出日志到引擎日志系统。

python
excore.log_info("玩家进入场景")
excore.log_warning("内存使用率较高")

set_window_title(title) ​

设置游戏窗口标题。

python
excore.set_window_title("我的游戏 v1.0")

get_window_title() ​

获取当前窗口标题。返回 str。

message_box_info(title, message) ​

弹出信息提示框。

python
excore.message_box_info("提示", "存档成功")

message_box_warning(title, message) ​

弹出警告提示框。

python
excore.message_box_warning("警告", "即将删除数据")

message_box_error(title, message) ​

弹出错误提示框。

python
excore.message_box_error("错误", "文件读取失败")

message_box_yesno(title, message) ​

弹出是/否确认框。返回 1(是) 或 0(否)。

python
if excore.message_box_yesno("确认", "确定要退出吗？"):
    excore.shutdown()

message_box_okcancel(title, message) ​

弹出确定/取消确认框。返回值同上。

shutdown() ​

关闭引擎（退出游戏）。

python
excore.shutdown()

get_engine_running() ​

获取引擎是否正在运行。返回 bool。

set_frame_limit(limit) ​

设置最大帧率限制（FPS 上限）。

python
excore.set_frame_limit(60)   # 限制 60 FPS
excore.set_frame_limit(0)    # 不限制

get_frame_limit() ​

获取当前帧率限制。返回 int。

窗口管理 (Windows/Linux) ​

create_window() ​

创建游戏窗口（需在初始化阶段调用）。

show_window() ​

显示窗口。

hide_window() ​

隐藏窗口。

get_window_width() ​

获取窗口宽度。返回 int。

get_window_height() ​

获取窗口高度。返回 int。

restore_key_callback() ​

恢复键盘回调（CocosUI 初始化后自动调用）。

玻璃效果 (Windows) ​

enable_glass() ​

启用窗口玻璃透明效果（黑色像素变透明）。

disable_glass() ​

禁用窗口玻璃透明效果。

set_window_icon(icon_path) ​

设置窗口图标。（仅 Windows，必须是真实文件系统路径）

参数类型说明
icon_pathstr.ico 文件的绝对路径
python
excore.set_window_icon("C:/MyGame/icon.ico")