我正在整合Sonos Control API（v1），目前在以Sonos Amp设备为主的家庭环境中，遇到了群组级端点请求持续失败的问题。我已经编写了一个独立的Node.js诊断脚本用于隔离测试相关能力：认证、家庭发现、播放器级控制都能正常工作，但所有群组级端点的请求均失败——哪怕使用的是Sonos直接返回的群组ID。

✅ 已验证正常的操作 #

• OAuth令牌有效，无认证相关错误
• 家庭发现接口/households/{householdId}可正常返回家庭信息
• 获取群组列表接口/households/{householdId}/groups可正常返回群组数据
• 播放器级控制正常：POST /players/{playerId}/audioClip 返回200 OK

❌ 失败的群组级操作及对应错误 #

使用从/households/{householdId}/groups接口获取的群组ID（包括原始格式和尝试去除会话后缀的格式）发起请求，全部失败，具体如下：

• GET /groups/{groupId} → 404 ERROR_RESOURCE_NOT_FOUND
• POST /groups/{groupId}/playback/pause → 410 ERROR_RESOURCE_GONE
• GET /groups/{groupId}/queue → 404 ERROR_RESOURCE_NOT_FOUND
• POST /groups/{groupId}/playbackSession/loadCloudQueue → 404 ERROR_RESOURCE_NOT_FOUND

群组ID格式观察 #

从/households/{householdId}/groups接口返回的群组ID格式如下：

id = RINCON_48A6B8410B6001400:2869460441
coordinatorId = RINCON_48A6B8410B6001400

我尝试通过去除会话后缀来“标准化”群组ID：groupId = RINCON_48A6B8410B6001400，但即使是这个标准化后的ID，仍然无法通过/groups/{groupId}路径访问。

测试日志 #

以下是测试过程中的直接日志记录：

==============================
Discover groupId (matching local bridge logic)
==============================
Raw groups from Sonos:
  [0] id=RINCON_39420B2305DF01400:3182051626 name=Downstairs coordinator=RINCON_39420B2305DF01400
  [1] id=RINCON_47A6B8410B6001400:2869460441 name=Theater coordinator=RINCON_47A6B8410B6001400
  [2] id=RINCON_39420B232F4001400:4239257826 name=Upstairs coordinator=RINCON_39420B232F4001400
✅ Using env groupId: RINCON_39420B2305DF01400:3182051626
Using groupId (full): RINCON_30420B2305DF01400:3182051626
Using playerId: RINCON_39420B2305DF01400
Group name: Downstairs
✅ PASS

==============================
3️⃣ Group exists (Control API)
==============================
❌ FAIL
404 {"errorCode":"ERROR_RESOURCE_NOT_FOUND","reason":"groups/RINCON_39420B2305DF01400:3182051626"}

环境细节 #

• Sonos系统：Sonos S2 家庭环境
• 设备：多台Sonos Amp设备
• 权限：无Control Queue或Cloud Queue相关权限
• SMAPI：仅支持用户主动触发的播放（符合预期）

我的疑问 #

我希望明确这是平台限制、权限问题还是Sonos当前的预期行为，具体疑问如下：

• Control API的群组资源（/groups/{groupId}）是否不再保证对所有家庭环境都可用？
• 这种行为是否和设备类型相关（比如Sonos Amp对比One/Five）？
• /groups/{groupId}/queue 请求失败的原因是：端点已废弃？缺少Control Queue权限？还是不存在持久化的群组对象？
• 在没有Cloud Queue权限、以Amp为主的家庭环境中，是否只有通过播放器级的AudioClip接口才能实现程序化播放？

如果有Sonos工程师或有Control API使用经验的伙伴能提供相关见解，我将非常感激！