客户端使用 ticket 创建实际 Travel，并获取 RTC 入会配置和 Adventure 能力版本。maxExperienceTimeSec 仅在 Adventure 模型中生效。
适用范围
客户端使用 ticket 创建实际 Travel，并获取 RTC 入会配置。maxExperienceTimeSec 仅在 Adventure 模型中生效。调用前请确认以下事项：
- 鉴权要求：不强制主 API Key，使用
ticket完成进房校验。获取方式请参见获取鉴权凭证。 - 前置条件：
ticket由获取体验凭证接口换取，未过期且未使用，对应 World 状态为ready。 - 调用方：您的客户端调用。
HTTP调用
- 新加坡
- 华北2（北京）
- 美国（弗吉尼亚）
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/enter-travel调用时请将{WorkspaceId}替换为真实的Workspace ID。请求参数 |
|
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。 | |
Authorization string （必选）API Key 鉴权。不强制主 API Key，主 API Key 或临时 API Key 均可调用。
| |
请求体（Request Body） | |
ticket string （必选）未过期且未使用的一次性凭证。由获取体验凭证接口换取。同一 ticket 再次使用返回 401011。 | |
maxExperienceTimeSec integer （可选）最大体验时长，单位秒，必须是 JSON 整数。默认 60。可选值：
"60" 不是合法值）；非法档位返回 400000。服务端在达到该时长后自动结束 Travel。 |
响应参数 |
|
code integer返回码。0 表示成功，非 0 为错误码。 | |
message string错误信息。成功时为 null。 | |
data object响应数据。失败时为 null。
属性 encryptedTravelId string新创建的加密 Travel ID。后续查询Travel状态、结束、产物查询均使用此值。encryptedWorldId string当前 Travel 对应的加密 World ID。mode integerAdventure 恒为 1。creationModel stringAdventure 恒为 simple。playUrl null暂不可用，固定为 null。firstFrame stringWorld 首帧 URL。rtcConfig objectRTC 入会配置；没有可用推流频道时为 null，客户端不能据此开始播放。
stringAdventure 进房版本，固定为 wanderV2。须按此版本通过 SDK sendCommand 发送控制数据。aspectRatio nullAdventure 固定为 null；播放器画幅不从本字段读取，跟随首帧图比例。noStreamAutoEndTimeoutSec integer无推流自动结束超时秒数，默认 30，以实际响应为准。进房后若在此时间内 rtcStatus 未进入推流态，应调用结束Travel并传入 failCode=TRAVEL_NO_STREAM_AUTO_END。maxExperienceTimeSec integer服务端实际采用的体验时长，只会是 60 / 90 / 120。达到该时长后服务端自动结束 Travel。 |
前置状态与调用注意事项
ticket对应的 World 必须为ready，且 ticket 未过期、未使用。- 调用成功即创建 Travel；同一
ticket再次使用返回401011。 version必须按wanderV2处理，不能按其它模型的交互协议发送控制数据。- 服务端在达到
maxExperienceTimeSec后结束体验，客户端应处理随后到达的终态。 - Adventure 的方向、视角和动作控制不是服务端 HTTP Open API，客户端必须使用对应平台 SDK 的
sendCommand，由 SDK 经 RTC DataChannel 发送。 rtcConfig=null表示当前没有可用推流频道，客户端不能据此开始播放。
错误码
如果模型调用失败并返回报错信息，请参见HappyOyster 错误码进行解决。
下一步
进房成功后：
- 查询Travel状态：每 2–5 秒轮询，读取可用动作池。
- Travel 为
running后，客户端通过 SDKsendCommand发送方向、视角和动作控制。 - 结束Travel：结束会话并处理产物。