控制网页工作区
在自己的计算机上运行 Python,向网站中的个人仿真发送指令。
准备 Python 和 VS Code
- 打开 WWW-POSIM 并登录,以 ROS 2 直接控制模式创建 WAM-V 世界,等待世界运行。
- 安装 VS Code 和 Microsoft 的 Python 扩展。
- 只需执行对应操作系统的命令。
.venv文件夹保存此项目所需的 Python 包。
Windows:PowerShell
安装 Python 安装管理器。从开始菜单打开新的 PowerShell 窗口,运行:
py install 3.14
mkdir "$HOME\posim-controller"
cd "$HOME\posim-controller"
py -3.14 -m venv .venv
.\.venv\Scripts\python.exe -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
Mac:终端
使用 Python.org 的安装程序安装 Python 3.14。打开应用程序 → 实用工具 → 终端,运行:
mkdir -p ~/posim-controller
cd ~/posim-controller
python3.14 -m venv .venv
.venv/bin/python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
Ubuntu:终端
按 Ctrl+Alt+T 打开终端,运行:
sudo apt update
sudo apt install -y python3-venv python3-pip
mkdir -p ~/posim-controller
cd ~/posim-controller
python3 -m venv .venv
.venv/bin/python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
sudo 可能要求输入计算机密码。输入时不会显示字符,完成后按回车。
在 VS Code 中运行程序
- 在 VS Code 中,通过文件 → 打开文件夹打开个人目录下的
posim-controller。 - 如果尚未安装,请安装 Microsoft 的 Python 扩展。
- Windows/Linux 按 Ctrl+Shift+P,Mac 按 Cmd+Shift+P 打开命令面板。搜索
Python: Select Interpreter,选择.venv中的解释器。 - 创建
controller.py,粘贴以下代码,将YOU@example.com替换为账号邮箱并保存。
from www_posim_ros import Session
with Session.remote(email="YOU@example.com", control=True) as sim:
topic = next(name for name, kind in sim.topics.items()
if kind == "nav_msgs/msg/Odometry")
print(sim.latest(topic)["pose"]["pose"]["position"])
sim.set_velocity(forward=0.3, yaw_rate=0.0, duration=2.0)
- 打开集成终端,运行对应系统的命令。
Windows:
.\.venv\Scripts\python.exe controller.py
Mac/Ubuntu:
.venv/bin/python controller.py
- 出现
Password:时输入 WWW-POSIM 密码并按回车。输入内容不可见。观察网站中 WAM-V 的运动。
程序在自己的计算机上运行,控制服务器上的个人工作区。导入软件包不会登录或连接;进入 with 代码块时才建立连接。
排查问题
No module named www_posim_ros:选择项目解释器,并用.venv中的 Python 重新安装软件包。- 没有新的遥测数据:确认世界正在运行且载具已经出现。话题存在不代表正在接收数据。
- 提示需要 ROS 2 直接控制工作区:选择该控制模式创建世界。
controller_busy:先停止控制同一世界的其他程序,再运行本程序。- 世界或载具已更换:重启程序以获取当前连接配置。
- 应用中的 ROS 工具无法使用:查看准备好的环境中的
~/.www-posim-ros/domain-76/client.log。必要时关闭并重新打开 ROS 工具。
从其他环境使用 ROS 话题的方法见 ROS 终端与连接。