Skip to content

⚙️ 全局基本配置

业务域名配置

由于不同业务方域名与国内网市场数据差异,不同的数据市场需要使用setProjectMode API不同的数据源才能实现获取数据,目前支持的数据源如下:

  • 国内市场:China默认
  • 国内市场缓存:ChinaCacheD 域名迁移 or 大流量项目使用
  • 国内市场测试环境:ChinaTest
  • 美股:Ainvest
  • 美股测试环境:AinvestTest

HXKline 全局配置

用于配置全局基本信息,如用户 id、数据时间范围、复权类型、数据请求步长、数据源、语言等。

TIP

  • 全局配置均为可选
  • 全局配置仅需配置一次,配置后会自动应用到所有实例化的图表实例中。
  • 全局配置修改后会自动应用到所有实例化的图表实例中。
  • 当业务方 Cookie 中不包含userIdsessionId字段时,需要由业务方提供,用于标识用户身份,否则会影响数据获取。
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;
}

Released under the Apache License V2.