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

YYPOST群发软件 发表于 6 天前

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

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

/*
🍎交流QQ群711841924群一，苹果内测群，528816639
🍎🔨脚本项目类方法小结
*/

/*
🍎快捷指令代理服务方法小结
*/

//======================== 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完整示例演示

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 ...

页: [1]

B2B网络软件's Archiver

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