APP-18179: Fix the audio, motion and pose tracker code samples

[Evgeni Dobranov (edobranov)]

https://viam.atlassian.net/browse/APP-18179

Background

examples/apis.json is the sample data app builds its Python code samples from. For each resource subtype it names the class to import, the method to call and the arguments to pass, and app's generator pastes those arguments verbatim into the call. App downloads the file from this repo's main on every frontend build (ui/scripts/postbuild.js), so a change here reaches app on its next deploy, with no SDK release involved.

Two features read it: the Connect tab's code samples, which are shown for copying, and the Control tab's code sandbox, which since APP-18068 runs the generated program inside a session sandbox whose Python image pins viam-sdk 0.80.0.

Problem

Checking every sample the sandbox can generate against that image found three entries whose programs cannot run:

• audio generates from viam.components.audio import Audio, a module the SDK has never had, so the program fails with ModuleNotFoundError: No module named 'viam.components.audio'. The key dates from the 2023 code-samples reformat, but the audio input component's subtype was audio_input, so no real resource ever matched it; audio_in and audio_out have since replaced that component and have their own entries.
• motion calls get_pose(), which raises for its missing component_name and destination_frame.
• pose_tracker calls get_poses(), which raises for its missing body_names.

An import error stops the program before its first line runs, and a raised call stops it at that block, so on any machine whose config has a motion service or a pose tracker the sandbox never gets through its samples.

Fix

Removes audio and passes the required arguments by keyword, so the sample names the argument a user would change: get_pose(component_name="world", destination_frame="world") and get_poses(body_names=[]). Asking for the world frame's pose in world succeeds on any machine and returns a zero pose; a comment above the call says to change the component name to get a real one. An empty body list returns every tracked body. Also re-indents the audio_in and audio_out entries to match the rest of the file.

Verified by generating the sandbox program for a machine with one resource of every subtype in this file, the way app's connectSamplesPythonSandbox does, then importing it and binding every generated call to its method's signature, against viam-sdk 0.80.0 (the Python sandbox image's pin) and 0.84.0: everything imports and every call binds. The same program generated from main fails on the audio import, and without that entry, on the two calls above. The matching fixes are in viamrobotics/rdk#6666 and viamrobotics/viam-typescript-sdk#1039.

🤖 Generated with Claude Code