1.2.3 获取进入应用URL

**1.2.3 获取启动应用URL**
**注意：在启动应用时候调用，获取到URL后立即访问，否则会超时而失效 **

| 请求方式  | GET  |
| ------------ | ------------ |
| **请求URL**  | http: // {LarkXR3.2管理服务器IP}:8181/appli/getStartURL  |

**升级说明**
- 接口地址由 “/getEnterAppliURL”变更为“/appli/getStartURL”
- 3.2.21版本开始，参数"roomCode"字段,变更为"authCode"

**参考样例 **
```
说明：appKey,timestamp,signature这三个参数有两种方式传递
一种是以参数的形式传递，例如：http://192.168.0.55:8181/appli/getStartURL?appKey=Jx5MQoo1& timestamp=1585729005673&signature=4C1BFE264A113A99C526BF5565EEBE642792A0B6&appliId=712678695067713536&codeRate=8000&frameRate=30
另一种是在OkHttp请求的header中传递，例如  :
Request.Builder builder = new Request.Builder().
                addHeader("appKey", "Jx5MQoo1")
                .addHeader("timestamp", "1585729005673")
                .addHeader("signature", "4C1BFE264A113A99C526BF5565EEBE642792A0B6")
                .url(apiUrl);
```

|名称   | 类型  | 是否必须  |描述|
| ------------ | ------------ | ------------ |------------ |
| appliId  |  Long |  必须 | |
| codeRate  |  Int | 可选  | 参见1.2.2 |
| frameRate | Int  | 可选  | 参见1.2.2 |
| extraParam.XXX  | String  | 可选  | 参见1.2.2 |
| regionId | String  | 可选  | 参见1.2.2 |
| groupId | String  | 可选  | 参见1.2.2 |
| appKey  |  String |  可选 | 参见1.2.2|
| timestamp  |  Long |  可选 | 参见1.2.2 |
| signature  |  String |  可选 | 参见1.2.2|
| playerMode | String  | 可选  | 参见1.2.2 |
| userType | String  | 可选  | 参见1.2.2 |
| roomCode(3.2.21版本废弃) | String  | 可选  | 参见1.2.2 |
| authCode(3.2.21版本新增) | String  | 可选  | 参见1.2.2 |
| nickname | String  | 可选  | 参见1.2.2 |

返回结果：

|名称   | 类型  | 是否必须  |  描述 |
| ------------ | ------------ | ------------ | ------------ |
|code | Integer  | 是  | 返回状态  |
|message  | String | 否  |返回消息  |
| result  | String  | 否  |返回进入应用的URL  |

**返回示例**

``` 
{
"code": 1000,
"result": "/webclient?appliId=879408743551336448&taskId=885538846769414144&taskStatus=0&network=1&codeRate=8000&frameRate=30&renderServerIp=192.168.0.28&renderServerPort=10002&preferPublicIp=&groupId=null&serverId=879407242258939904&wsProxy=1&initWinSize=0&initCursorMode=0&fullScreenMode=0&bgColor=&mobileForceLandscape=1&mobileVirtualJoystick=1&useGamepad=0&mouseZoomDirection=1&playerListToggle=1&noOperationTimeout=0&touchOperateMode=mouse&logLevel=warn&rttLimit=60&rttLimitInterval=20&language=zh-CN&random=1631170513684"
```

获取到进入应用的URL后，通过URL进入应用，比如将URL赋给iframe的src，在iframe中打开展示应用界面。
当LarkXR的Web客户端嵌入到iframe中使用时，可以在iframe外层通过Javascript监听获取LarkSR Web客户端发出的状态消息。监听的代码示例如下：

```
window.addEventListener("message", function(e) {
    console.log("receive message." + e.data.prex, e.data.type, e.data.message);
}, false);
```
其中 data 的数据格式为：
```
data: {
    "prex":"pxymessage",         // 消息的前缀。固定为 pxymessage。
    "type":"100",                // 消息类型。 
    "message":"连接信令服务器成功" // 消息的文字说明。
}
```
消息详情请[下载](https://www.pingxingyun.com/devCenter.html "下载")查看【数据通道_与客户端通信demo】