cURL - 客户端进入房间
适用范围
调用前请确认:
- 不强制主 API Key,使用
ticket完成进房校验。 ticket由获取体验凭证接口换取,未过期且未使用,对应 World 状态为ready。version固定为wanderV2,须按此版本通过 SDKsendCommand发送控制数据。
客户端使用 ticket 创建实际 Travel,并获取 RTC 入会配置和 Adventure 能力版本。maxExperienceTimeSec 仅在 Adventure 模型中生效。
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/enter-travel' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"ticket": "{ticket}",
"maxExperienceTimeSec": 90
}'{
"code": 0,
"message": null,
"data": {
"encryptedTravelId": "trvl_a1b2****",
"encryptedWorldId": "enc_a1b2****",
"mode": 1,
"creationModel": "simple",
"playUrl": null,
"firstFrame": "https://cdn.happyoyster.com/frames/world_xyz789.jpg",
"rtcConfig": {
"channelId": "stream_abc123",
"appId": "18bca2e3218c46aebf8ff3a32fb12311",
"token": "007eJxTYOh...",
"userId": "user_1"
},
"version": "wanderV2",
"aspectRatio": null,
"noStreamAutoEndTimeoutSec": 30,
"maxExperienceTimeSec": 90
}
}ticket 完成进房校验。ticket 由获取体验凭证接口换取,未过期且未使用,对应 World 状态为 ready。version 固定为 wanderV2,须按此版本通过 SDK sendCommand 发送控制数据。千问AI平台 API Key。仅支持主 API Key(sk- 开头)。详见获取 API Key。
返回码。0 表示成功,非 0 为错误码。
错误信息。成功时为 null。
响应数据。失败时为 null。
显示子属性
新创建的加密 Travel ID。后续查询Travel状态、结束、产物查询均使用此值。
当前 Travel 对应的加密 World ID。
Adventure 恒为 1。
Adventure 恒为 simple。
暂不可用,固定为 null。
World 首帧 URL。
Adventure 进房版本,固定为 wanderV2。须按此版本通过 SDK sendCommand 发送控制数据。
Adventure 固定为 null;播放器画幅不从本字段读取,跟随首帧图比例。
无推流自动结束超时秒数,默认 30,以实际响应为准。进房后若在此时间内 rtcStatus 未进入推流态,应调用结束Travel并传入 failCode=TRAVEL_NO_STREAM_AUTO_END。
服务端实际采用的体验时长,只会是 60 / 90 / 120。达到该时长后服务端自动结束 Travel。
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/enter-travel' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"ticket": "{ticket}",
"maxExperienceTimeSec": 90
}'{
"code": 0,
"message": null,
"data": {
"encryptedTravelId": "trvl_a1b2****",
"encryptedWorldId": "enc_a1b2****",
"mode": 1,
"creationModel": "simple",
"playUrl": null,
"firstFrame": "https://cdn.happyoyster.com/frames/world_xyz789.jpg",
"rtcConfig": {
"channelId": "stream_abc123",
"appId": "18bca2e3218c46aebf8ff3a32fb12311",
"token": "007eJxTYOh...",
"userId": "user_1"
},
"version": "wanderV2",
"aspectRatio": null,
"noStreamAutoEndTimeoutSec": 30,
"maxExperienceTimeSec": 90
}
}