附加参数

存在两种额外的参数传递格式：短横线格式和GNU长参数格式，它们为我们提供了更好的参数传递选项。让我们来看看具体的使用方法。•短横线格式：在URL中追加`&extraParam.cmdLineParamStyle=2`参数。

```
http://[server_ip]:8181/enterAppli?appliId=[application_id]&extraParam.userName=zhangsan&extraParam.age=12&extraParam.cmdLineParamStyle=2

```
![](https://docs.paraverse.cc/media/202510/372dd818151744078e6de8b6c22aa9139192.png)

•GNU长参数格式：在URL中追加`&extraParam.cmdLineParamStyle=1`参数。
```
http://[server_ip]:8181/enterAppli?appliId=[application_id]&extraParam.userName=zhangsan&extraParam.age=12&extraParam.cmdLineParamStyle=1

```

![](https://docs.paraverse.cc/media/202510/f778aa91fc9a4d7eb0f56ff7a5efadda8185.png)

•完全不要追加`&extraParam.cmdLineParamStyle`参数。

```
http://[server_ip]:8181/enterAppli?appliId=[application_id]&extraParam.userName=zhangsan&extraParam.age=12

```

![](https://docs.paraverse.cc/media/202510/f469d9ba51bd4bac8460b8d804581f991300.png)

三种参数传递格式的效果分别按照短横线格式、GNU长参数格式和默认参数的顺序进行了展示。此外，我们还引入了一个功能来处理额外参数中特殊字符的编码。使用方法如下：
```
"https://XXXX?extraParam.encoded.token=" + encodeURIComponent(jsonValue)

```
例如 :

```
https://XXXX?appliId=**&extraParam.encoded.X=-ResX%3D2560&extraParam.encoded.Y=-ResY%3D1350
```
以上是直接拼接到URL参数中的试验方法。如果你正在使用WebSDK来传递额外的参数，请参考以下方法。WebSDK提供了多个示例，例如sample-plain-html和ui-mobile-vue-new示例。

![](https://docs.paraverse.cc/media/202510/b0fad058ddac4c26802d12b02399d0153321.png)
**Sample 1：sample-plain-html**
打开`sample-plain-html/index.html`修改以下代码

```
client.connect({
 appliId: "925773094113509376",
 ....
 "extraParam.params": "zhangsan 12"**
})
```

**Sample 2：ui-mobile-vue-new**
打开`ui-mobile-vue-new/src/App.vue`文件，并在`start()`方法中添加以下内容。
```
async start() {
  const { larksr } = this;
  try {
    let params = {};
    params.appliId = '1420437156576362496'
    var extraParams = {};
    extraParams['extraParam.test'] = "zhangsan 12";
    if(Object.keys(extraParams).length>0) {
     params = Object.assign(params, extraParams)
}
....
```

或者，在使用`larksr.connect`方法连接到云渲染时，添加以下参数。

```
 client.connect({
 appliId: "925773094113509376",
 ....
 "extraParam.params": "zhangsan 12"
})
```