Panel SDK

Appearance

🎬🚀 动画设置（BootAnimation）模块 · 开发者指南 ​

🧠 模块介绍 ​

动画设置模块，为 Android 设备开机动画赋能，支持企业级定制、品牌个性化、批量部署与一键还原。无缝集成 PanelSDK，助力打造极致用户体验。

🛠️ PanelSDK 初始化 ​

java
// 推荐在 Application 或 Activity 中初始化，确保全局唯一
PanelSDK panelSDK = new PanelSDK(this);

🧩 核心方法 · 专业解读 ​

🌈 setBootanimation — 高级自定义启动动画 ​

java
int setBootanimation(String bootanimationPath)
参数说明
参数类型说明
bootanimationPathString动画 zip 文件的绝对路径，支持本地/远程路径
返回值说明
返回值说明
0操作成功，动画已生效
-1未知错误或路径无效/文件不存在
-2权限不足，无法写入系统目录
-3动画文件格式错误或不兼容
-801动画文件不存在
-802动画文件校验失败
-803动画文件复制失败
-804参数错误
-805无法删除旧动画文件
-806动画文件类型错误
-807非标准 zip 文件
其他具体错误码请参考 ErrorCode.java 或 API 文档
典型场景代码
java
int result = panelSDK.setBootanimation("/sdcard/bootanimation.zip");
if (result == 0) {
    // 🎉 开机动画已焕新，品牌形象瞬间升级！
} else if (result == -1 || result == -801) {
    // 📂 路径无效或文件不存在，建议检查文件路径和权限
} else if (result == -2) {
    // 🔒 权限不足，需系统/Root授权
} else if (result == -3 || result == -806 || result == -807) {
    // ⚠️ 文件格式不兼容或类型错误，请使用标准 bootanimation.zip
} else if (result == -802) {
    // ⚠️ 文件校验失败，请检查动画包完整性
} else if (result == -803) {
    // ⚠️ 文件复制失败，可能存储空间不足或权限问题
} else if (result == -804) {
    // ⚠️ 参数错误，请检查接口调用参数
} else if (result == -805) {
    // ⚠️ 无法删除旧动画文件，可能权限不足
} else {
    // ❗ 其他错误，参考 ErrorCode.java 或 API 文档
}

🌀 resetBootanimation — 极速恢复系统动画 ​

java
int resetBootanimation()
参数说明
参数类型说明
无恢复为系统原生动画，支持批量设备还原
返回值说明
返回值说明
0恢复成功，系统动画已还原
-1权限不足，无法恢复
-801系统动画文件缺失
-803系统动画文件复制失败
-805无法删除动画文件
其他具体错误码请参考 ErrorCode.java 或 API 文档
典型场景代码
java
int result = panelSDK.resetBootanimation();
if (result == 0) {
    // 🏁 恢复成功，设备回归原厂体验！
} else if (result == -1) {
    // 🔒 权限不足，需系统/Root授权
} else if (result == -801) {
    // ⚠️ 系统动画文件缺失，请检查系统完整性
} else if (result == -803) {
    // ⚠️ 文件复制失败，可能存储空间不足或权限问题
} else if (result == -805) {
    // ⚠️ 无法删除动画文件，可能权限不足
} else {
    // ❗ 其他错误，参考 ErrorCode.java 或 API 文档
}

⚡ 专业进阶 · 技术要点 ​

所有方法均为同步调用，返回值可直接判断结果，适合批量自动化脚本。 推荐在具备系统权限的环境下调用，部分功能需 Root 或系统签名。 依赖底层 StBootanimationManager，请确保相关依赖已集成并兼容目标设备。 支持企业级批量部署、远程 OTA 动画下发。

🏆 专业总结 ​

只需一个 PanelSDK 实例，开机动画随心掌控。无论是品牌定制、批量运维还是一键还原，BootAnimation 模块让你的设备体验更专业、更酷炫、更高效！