# Rcp_SessionConfiguration

> phone 5.0.0(12)+ | 2in1 5.0.1(13)+ | tablet 5.0.0(12)+ | tv 5.1.1(19)+ | wearable 5.1.0(18)+

## 概述

会话配置。

**起始版本：** 5.0.0(12)

**相关模块：** [RemoteCommunication](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview)

**所在头文件：** [rcp.h](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/rcp_8h)

## 汇总

### 成员变量

|名称|描述|
|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------|
|[Rcp_SessionType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_sessiontype) [type](#type)|会话类型。|
|[Rcp_InterceptorArray](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___interceptor_array) [interceptors](#interceptors)|用户自定义的异步拦截器数组。|
|[Rcp_SyncInterceptorArray](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___sync_interceptor_array) [syncInterceptors](#syncinterceptors)|用户定义的同步拦截器数组。|
|const char * [baseUrl](#baseurl)|基本URL。|
|[Rcp_Headers](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_headers) * [headers](#headers)|请求标头。|
|[Rcp_RequestCookies](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_requestcookies) * [cookies](#cookies)|请求的Cookie。|
|[Rcp_SessionListener](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___session_listener) [sessionListener](#sessionlistener)|回调函数，供session监听close()或cancel()事件。|
|[Rcp_Configuration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___configuration) * [requestConfiguration](#requestconfiguration)|默认请求配置。这些选项可以通过[Request.configuration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___request#configuration)覆盖。|
|[Rcp_ConnectionConfiguration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___connection_configuration) [connectionConfiguration](#connectionconfiguration)|连接配置。|

## 结构体成员变量说明

### baseUrl

```cpp
const char* Rcp_SessionConfiguration::baseUrl
```

**描述**

基本URL。

例如：请求的url为 '?name=value', 基本url是 "https://example.com"，那么最后当请求被送往服务端时的最终url为 "https://example.com?name=value"。

### connectionConfiguration

```cpp
Rcp_ConnectionConfiguration Rcp_SessionConfiguration::connectionConfiguration
```

**描述**

连接配置。

它用于指定此会话中允许的最大同时连接总数以及允许连接到单个主机的最大同时连接数。

### cookies

```cpp
Rcp_RequestCookies* Rcp_SessionConfiguration::cookies
```

**描述**

请求的Cookie。

如果调用了[HMS_Rcp_Fetch](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#hms_rcp_fetch)或者[HMS_Rcp_FetchSync](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#hms_rcp_fetchsync)，在参数中的[Rcp_Request](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___request)中没有[Rcp_RequestCookies](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_requestcookies)，则[Rcp_SessionConfiguration.cookies](#cookies)将是[Rcp_Request.cookies](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___request#cookies)，如果两者都存在，则将它们合并。

### headers

```cpp
Rcp_Headers* Rcp_SessionConfiguration::headers
```

**描述**

请求标头。

如果调用了[HMS_Rcp_Fetch](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#hms_rcp_fetch)或[HMS_Rcp_FetchSync](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#hms_rcp_fetchsync)，并且[Rcp_Request](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___request)中没有[Rcp_Headers](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_headers)，[Rcp_SessionConfiguration.headers](#headers)将是[Rcp_Request.headers](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___request#headers)，如果两者都存在，则将它们合并。

### interceptors

```cpp
Rcp_InterceptorArray Rcp_SessionConfiguration::interceptors
```

**描述**

用户自定义的异步拦截器数组。

异步拦截器将被制成拦截器链。

输入: [A, B, C, D]， 处理逻辑将为 A->B->C->D->defaultHandler。

### requestConfiguration

```cpp
Rcp_Configuration* Rcp_SessionConfiguration::requestConfiguration
```

**描述**

默认请求配置。这些选项可以通过[Request.configuration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_rcp___request#configuration)覆盖。

### sessionListener

```cpp
Rcp_SessionListener Rcp_SessionConfiguration::sessionListener
```

**描述**

回调函数，供session监听close()或cancel()事件。

### syncInterceptors

```cpp
Rcp_SyncInterceptorArray Rcp_SessionConfiguration::syncInterceptors
```

**描述**

用户定义的同步拦截器数组。

同步拦截器会被做成拦截器链。

输入: [A, B, C, D], 处理逻辑将为 A->B->C->D->defaultHandler。

### type

```cpp
Rcp_SessionType Rcp_SessionConfiguration::type
```

**描述**

会话类型。