Panel SDK

Appearance

🌐 NetCoexist（网络共存）模块 · 开发者指南 ​

🧠 模块介绍 ​

NetCoexist（网络共存）模块，用于智能管理设备多网络（如有线、WiFi、蜂窝）共存与优先级，支持灵活切换与批量配置。

🛠️ PanelSDK 初始化 ​

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

🧩 核心方法 · 专业解读 ​

🥇 getNetworkSequence — 获取网络优先级顺序 ​

java
int[] getNetworkSequence()
返回值说明
返回值说明
int[]长度为3的优先级数组，第一个元素优先级最高，如 [1,0,9]
典型场景代码
java
// 获取网络优先级顺序
int[] sequence = panelSDK.getNetworkSequence();
if (sequence != null && sequence.length == 3) {
    // ✅ 获取成功
    Log.d("NetCoexist", "网络优先级顺序: [" + sequence[0] + ", " + sequence[1] + ", " + sequence[2] + "]");
    // 0: 以太网, 1: WiFi, 9: 移动网络
} else {
    // ⚠️ 获取失败
    Log.w("NetCoexist", "获取网络优先级失败");
}

🔀 netCoexistenceSwitch — 开关网络共存 ​

java
int netCoexistenceSwitch(boolean enable)
参数说明
参数类型说明
enablebooleantrue 开启，false 关闭
返回值说明
返回值说明
0成功
其他失败
典型场景代码
java
// 开启网络共存功能
int result = panelSDK.netCoexistenceSwitch(true);
if (result == 0) {
    // 🎉 开启成功
    Log.d("NetCoexist", "网络共存功能已开启");
} else {
    // ❌ 开启失败
    Log.e("NetCoexist", "开启失败，错误码: " + result);
}

🟢 getNetCoexistenceState — 查询网络共存状态 ​

java
boolean getNetCoexistenceState()
返回值说明
返回值说明
true/falsetrue 开启，false 关闭或失败
典型场景代码
java
// 查询网络共存功能状态
boolean isEnabled = panelSDK.getNetCoexistenceState();
if (isEnabled) {
    // ✅ 网络共存功能已开启
    Log.d("NetCoexist", "网络共存功能已开启");
} else {
    // ⚠️ 网络共存功能未开启或查询失败
    Log.w("NetCoexist", "网络共存功能未开启");
}

🧩 setNetworkPriority — 设置网络优先级顺序 ​

java
int[] setNetworkPriority(String[] networkPriority)
参数说明
参数类型说明
networkPriorityString[]长度为3的优先级数组，第一个元素优先级最高，如 ["1","0","9"]
返回值说明
返回值说明
int[]设置后的优先级数组
典型场景代码
java
// 设置网络优先级顺序：WiFi > 以太网 > 移动网络
String[] priority = {"1", "0", "9"}; // 1=WiFi, 0=以太网, 9=移动网络
int[] result = panelSDK.setNetworkPriority(priority);
if (result != null && result.length == 3) {
    // ✅ 设置成功
    Log.d("NetCoexist", "网络优先级已设置为: [" + result[0] + ", " + result[1] + ", " + result[2] + "]");
} else {
    // ❌ 设置失败
    Log.e("NetCoexist", "设置网络优先级失败");
}

⚡ 专业进阶 · 技术要点 ​

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

🏆 专业总结 ​

只需一个 PanelSDK 实例，多网共存与优先级策略一站式搞定。无论是高可用、智能切换还是批量运维，NetCoexist 模块让你的设备网络管理更智能、更高效！