⚙️ 全局基本配置
业务域名配置
由于不同业务方域名与国内网市场数据差异,不同的数据市场需要使用setProjectMode API不同的数据源才能实现获取数据,目前支持的数据源如下:
- 国内市场:
China
(默认) - 国内市场缓存:
ChinaCache
(D 域名迁移 or 大流量项目使用) - 国内市场测试环境:
ChinaTest
- 美股:
Ainvest
- 美股测试环境:
AinvestTest
HXKline 全局配置
用于配置全局基本信息,如用户 id、数据时间范围、复权类型、数据请求步长、数据源、语言等。
TIP
- 全局配置均为可选
- 全局配置仅需配置一次,配置后会自动应用到所有实例化的图表实例中。
- 全局配置修改后会自动应用到所有实例化的图表实例中。
- 当业务方 Cookie 中不包含
userId
和sessionId
字段时,需要由业务方提供,用于标识用户身份,否则会影响数据获取。
typescript
{
// ws和http请求需要携带的Header头
headers: Record<string, string | undefined> = {
udid: undefined,
deviceModel: undefined,
deviceName: undefined,
};
// 全局数据复权类型(1.0.9后默认值由不复权改为前复权)
adjustType: AdJustType = AdJustType.Forward;
// 滚动加载时单次请求数据量(默认宽度下,1080p屏幕+20%冗余width)
dataStepCount = 350;
// 全局数据源
sourceAPIMode: SourceModeMap = SourceModeMap.China;
// 全局语言
locale = Languages.ZH_CN;
// 全局时区(分时默认使用系统时区、K线图使用交易所时区)
timeZone: string | undefined = undefined;
// ws心跳检测间隔 <30s,注意,心跳检测时间要大于wsRequestTimeOut
wsHeartBeatInterval = 15000;
// ws订阅请求,服务器反馈超时时间 6s,超时后重连
wsRequestTimeOut = 6000;
// ws重连最大次数 14400 (24h),不能为0
wsReConnectMaxTimes = 14400;
// ws推送频率,默认500ms(慎重修改)
pushLevel = pushLevel.ms_500;
// 绕过鉴权标识符:0-鉴权(默认,国内美股需要特定权限)、1-绕过、2-登陆即返回实时(注意,绕过鉴权返回15min延时数据)
gpid = GpidAuthType.Auth;
// ws服务id
wsProgramId = 7047;
// 使用interval轮询数据时默认时间间隔:6s
pollingIntervalTime = 6000;
// 是否启用成交量"手"单位换算
useVolumeUnit = false;
// 是否开启市场级别状态管理(例如类似全局市场状态和时间轴状态统一处理,避免重复请求)
// 注意:如果开启则跟随DataFeed生命周期,DataFeed销毁时会自动销毁StatusManagement,其他时间一直存在
marketStatusManagement = false;
// 全局埋点开关
disableAnalytics = false;
}