打开指纹浏览器窗口
指令说明
打开指定的比特浏览器或AdsPower浏览器窗口,并返回该窗口中曲辕RPA插件生成的envId。
envId用于后续在指定指纹浏览器窗口执行网页自动化,例如打开网页、获取已打开的网页、获取已打开的所有网页、浏览器下载文件等指令。
指令输入参数
| 输入参数 | 输入参数类型 | 说明 |
|---|---|---|
| 浏览器类型 | 枚举项 | 比特浏览器、AdsPower |
| 浏览器窗口ID | str | 比特浏览器或AdsPower中的浏览器窗口ID,不是曲辕RPA插件的envId |
| 服务端端口 | int/str | 必填;指纹浏览器本地服务端口,比特浏览器通常为54345,AdsPower通常为50325;如果本地API端口被修改,请填写实际端口 |
| API Token | str | 仅选择比特浏览器时需要该参数;比特浏览器本地API配置了API Token时填写,留空则不传认证参数 |
| AdsPower API Key | str | 仅选择AdsPower时需要该参数;如果AdsPower本地API开启了安全验证,则必须填写API Key,留空则不传认证参数 |
| 等待打开超时时间 | int/float | 高级参数,等待指纹浏览器窗口打开并连接曲辕RPA插件的最长时间,默认60秒 |
指令输出参数
| 输出参数 | 输出参数类型 | 说明 |
|---|---|---|
| envId | str | 打开的指纹浏览器窗口对应的envId |
提示
需要先安装并启用曲辕RPA浏览器插件。比特浏览器需要开启本地API(常用端口54345),AdsPower需要开启本地API(常用端口50325)。服务端端口为必填参数,运行时只使用指令中填写的端口,留空会直接报错。如果比特浏览器配置了API Token,请在指令中填写API Token;如果AdsPower提示Require api-key,请在指令中填写AdsPower本地API的API Key。认证字段留空时不会传认证参数。
使用说明
- 从比特浏览器或AdsPower复制目标浏览器窗口ID。
- 填写对应指纹浏览器的服务端端口;比特浏览器通常为54345,AdsPower通常为50325,端口不能为空。
- 如果选择比特浏览器且本地API配置了API Token,请填写API Token;如果选择AdsPower且本地API开启了安全验证,请填写AdsPower API Key。
- 如窗口启动较慢,可以在高级设置中调大等待打开超时时间,默认60秒。
- 使用本指令打开该窗口,并将输出的envId保存到变量。
- 后续需要指定指纹浏览器窗口的网页指令中,将envId参数设置为上一步保存的变量。
常见问题
如果打开窗口成功但未获取到envId,请确认该窗口已经安装并启用曲辕RPA浏览器插件。
如果提示本地API连接失败,请确认比特浏览器或AdsPower客户端已经启动,并且本地API功能已经开启。
如果比特浏览器接口提示认证失败,请确认API Token已填写正确;未配置API Token时留空即可。
如果AdsPower提示Require api-key,说明AdsPower本地API开启了安全验证,请在指令中填写API Key。