AIWROK软件苹果IOS快捷指令代理服务[shortAgent]方法小结

QQ896757558 · 发表于 2025-8-29 05:02:26

/*
🍎交流QQ群711841924群一，苹果内测群，528816639
🍎🔨脚本项目类 [project] 方法小结
*/
/*
🍎快捷指令代理服务[shortAgent]方法小结
*/
//======================== 1. openApp 启动 App ========================//
/*
类别详情说明
方法功能通过 App 名称后台直接启动应用
方法签名 Void openApp(String name)
返回值 Void（无返回值）
参数 - String name：需启动的 App 名称（如 "微信"、"支付宝"，需与系统识别名一致）
*/
// 示例：启动微信（实际名称需匹配系统定义）
shortAgent.openApp("微信");
//======================== 2. openUrl 打开网址/Scheme ========================//
/*
类别详情说明
方法功能打开指定网址（如 https://...）或 App Scheme（如 weixin://...）
方法签名 Void openUrl(String name)
返回值 Void（无返回值）
参数 - String name：网址或 Scheme 字符串（如 "https://www.baidu.com" 或 "twitter://"）
*/
// 示例：打开百度网址
shortAgent.openUrl("https://www.baidu.com");
//======================== 3. openSelf 自启动（打开 aiwork） ========================//
/*
类别详情说明
方法功能自启动关联应用（如 aiwork，需环境支持该逻辑）
方法签名 Void openSelf()
返回值 Void（无返回值）
参数无
*/
// 示例：自启动 aiwork
shortAgent.openSelf();
//======================== 4. screenShot 代理截屏 ========================//
/*
类别详情说明
方法功能通过快捷方式代理截屏，返回 Image 类型的截屏结果
方法签名 Image screenShot()
返回值 Image（截屏得到的图像对象，可用于后续处理）
参数无
*/
// 示例：代理截屏并保存（假设支持 Image 方法）
let screenshot = shortAgent.screenShot();
screenshot.save("/sdcard/agent_screenshot.png");
//======================== 5. getTopApp 获取顶端 App（iOS 18+） ========================//
/*
类别详情说明
方法功能获取当前顶端运行的 App 名称（仅支持 iOS 18+ 系统，低版本返回空/无效值）
方法签名 String getTopApp()
返回值 String（顶端 App 的名称，如 "com.tencent.wechat" 或空字符串）
参数无
*/
// 示例：获取并打印顶端 App 名称
let topAppName = shortAgent.getTopApp();
print.log("当前顶端 App：" + topAppName);
/*
📌 关键说明：
1. **openApp 注意事项**：App 名称需与系统“显示名称”或包名匹配（如 iOS 用 Bundle Name，Android 用包名），否则启动失败。
2. **openUrl 兼容性**：Scheme 需提前在系统注册（如微信 Scheme `weixin://`），否则会跳转失败。
3. **getTopApp 限制**：仅 iOS 18+ 系统支持，低版本调用可能返回空或报错，需做版本判断。
4. **screenShot 权限**：代理截屏需应用具备“屏幕录制”或“截图”权限，否则可能返回空。
*/

复制代码

openApp启动app

项目	详情
功能描述	启动 app，通过 app 名字后台直接启动 app
方法定义	Void openApp(String name)
返回值	Void
参数	String name: app 名称
案例	shortAgent.openApp("")

📌appopenUrl打开网址或者Scheme

项目	详情
功能描述	打开网址或者 Scheme
方法定义	Void openUrl(String name)
返回值	Void
参数	String name: 网址或者 Scheme
案例	shortAgent.openUrl("")

📌openSelf自启动

项目	详情
功能描述	自启动（打开 aiwork）
方法定义	Void openSelf()
返回值	Void
参数	无
案例	shortAgent.openSelf()

📌screenShot代理截屏

项目	详情
功能描述	代理截屏（使用快捷方式截屏）
方法定义	Trial screenShot()
返回值	Image
参数	无
案例	shortAgent.screenShot()

📌getTopApp 获取顶端app(I0S18+)

项目	详情
功能描述	获取顶端 app（iOS 18+，系统需为 18+ 才能获取顶端 app 名称）
方法定义	String getTopApp()
返回值	String
参数	无
案例	shortAgent.getTopApp()

特别示例：

// ... existing code ...
/*
🍎交流QQ群711841924群一，苹果内测群，528816639
🍎🔨快捷指令代理服务[shortAgent]使用示例
*/
// 🔨shortAgent完整示例演示
printl("=== shortAgent方法使用示例 ===");
// 1. 📌openSelf 自启动（打开 aiwork）
printl("\n1. 使用openSelf()方法自启动aiwork:");
try {
shortAgent.openSelf();
printl(" 调用openSelf()方法完成");
} catch (e) {
printl(" 调用openSelf()失败: " + e);
}
// 使用系统提供的delay方法替代sleep
delay(2);
// 2. 📌openApp 启动 App
printl("\n2. 使用openApp()方法启动应用:");
try {
// 启动系统设置应用
shortAgent.openApp("设置");
printl(" 尝试启动设置应用");
} catch (e) {
printl(" 启动设置应用失败: " + e);
}
// 等待应用启动
delay(3);
// 3. 📌openUrl 打开网址/Scheme
printl("\n3. 使用openUrl()方法打开网址:");
try {
// 打开苹果官网
shortAgent.openUrl("https://www.apple.com");
printl(" 尝试打开苹果官网");
} catch (e) {
printl(" 打开网址失败: " + e);
}
// 等待页面加载
delay(3);
// 4. 📌getTopApp 获取顶端 App（iOS 18+）
printl("\n4. 使用getTopApp()方法获取顶端运行的应用:");
try {
let topAppName = shortAgent.getTopApp();
if (topAppName && topAppName.length > 0) {
printl(" 当前端运行的应用: " + topAppName);
} else {
printl(" 无法获取顶端应用信息（可能不是iOS 18+系统或无权限）");
}
} catch (e) {
printl(" 获取顶端应用失败: " + e);
}
// 5. 📌screenShot 代理截屏
printl("\n5. 使用screenShot()方法进行代理截屏:");
try {
let screenshot = shortAgent.screenShot();
if (screenshot) {
printl(" 截屏成功");
// 注意：Image对象的save方法可能不可用，这里仅作示例
printl(" 截屏对象已获取，可用于后续处理");
} else {
printl(" 截屏失败，返回空对象");
}
} catch (e) {
printl(" 截屏操作失败: " + e);
}
printl("\n=== shortAgent方法使用示例结束 ===");
// 综合应用场景示例
printl("\n=== 综合应用场景示例 ===");
function demonstrateShortAgentWorkflow() {
printl("开始演示shortAgent工作流程:");
// 1. 启动Safari浏览器
printl("1. 启动Safari浏览器");
try {
shortAgent.openApp("Safari");
printl(" 已发送启动Safari指令");
} catch (e) {
printl(" 启动Safari失败: " + e);
}
delay(2);
// 2. 打开特定网页
printl("2. 打开GitHub网站");
try {
shortAgent.openUrl("https://github.com");
printl(" 已发送打开GitHub指令");
} catch (e) {
printl(" 打开GitHub失败: " + e);
}
delay(3);
// 3. 获取当前顶端应用
printl("3. 检查当前顶端应用");
try {
let currentApp = shortAgent.getTopApp();
printl(" 当前端应用: " + (currentApp || "未知或无权限"));
} catch (e) {
printl(" 获取顶端应用信息失败: " + e);
}
// 4. 截屏
printl("4. 对当前页面进行截屏");
try {
let screenImage = shortAgent.screenShot();
if (screenImage) {
printl(" 截屏成功完成");
} else {
printl(" 截屏失败");
}
} catch (e) {
printl(" 截屏操作失败: " + e);
}
// 5. 返回aiwork
printl("5. 返回aiwork应用");
try {
shortAgent.openSelf();
printl(" 已发送返回aiwork指令");
} catch (e) {
printl(" 返回aiwork失败: " + e);
}
printl("工作流程演示完成!");
}
// 运行综合示例
demonstrateShortAgentWorkflow();
// 注意事项说明
printl("\n📌 shortAgent使用注意事项:");
printl("1. openApp方法需要应用名称与系统识别名匹配");
printl("2. openUrl支持网址和应用Scheme");
printl("3. getTopApp仅支持iOS 18+系统且需要相应权限");
printl("4. screenShot需要屏幕录制权限支持");
printl("5. 所有操作为异步调用，实际执行需要时间");
printl("6. 使用delay()替代sleep()进行延时等待");
// ... existing code ...

复制代码