open-index/open-npm huggingface dataset:
npm package: @shenyin/embedded-call-widget
Description: ```bash npm install @shenyin/embedded-call-widget ```
Latest version: 3.1.2

# @shenyin/embedded-call-widget

## 安装

```bash
npm install @shenyin/embedded-call-widget
```

## ESM

适用于 Vue / React / 现代 bundler；默认不需要传 `runtimeUrl`。

```js
import { createCallButton } from '@shenyin/embedded-call-widget'

createCallButton({
  mount: '#call-button',
  apiBaseUrl: 'https://your-gateway.example/proxy/',
  siteKey: 'your-site-key',
  text: '值班员',
  callerInfo: { nickname: '张三', stStatus: '未三退' },
  accessToken: 'site-token-123',
  advanced: {
    visitorBusinessKey: 'your-visitor-business-key'
  }
})
```

## IIFE

适用于 `script` / CDN / 自托管静态资源；默认按脚本相对路径推断 runtime。

```html
<div id="call-button"></div>
<script src="https://cdn.jsdelivr.net/npm/@shenyin/embedded-call-widget@3.1.2/embedded-call-widget.iife.js"></script>
<script>
  EmbeddedCallWidget.createCallButton({
    mount: '#call-button',
    apiBaseUrl: 'https://your-gateway.example/proxy/',
    siteKey: 'your-site-key',
    text: '值班员',
    callerInfo: { nickname: '张三', stStatus: '未三退' },
    accessToken: 'site-token-123',
    advanced: {
      visitorBusinessKey: 'your-visitor-business-key'
    }
  })
</script>
```

## 参数

- 必填：`mount`、`apiBaseUrl`、`siteKey`
- 可选：`text`、`callerInfo`、`businessKey`、`advanced.visitorBusinessKey`、`displayName`、`runtimeUrl`、`runtimeModuleLoader`、`transportBaseUrl`、`accessToken`、`debug`
- `text`：访客主动拨打面板中的呼叫对象名，默认 `联系管理员`
- `callerInfo`：平台端展示的访客身份上下文，形如 `{ nickname: '张三', stStatus: '未三退' }`
- 回调：`onStateChange`、`onStandbyReady`、`onIncomingCall`、`onCallAnswered`、`onCallRejected`、`onCallMissed`
- `runtimeUrl`：主要给 `IIFE / CDN / 自托管静态资源`；`ESM import` 误传时默认忽略
- 默认普通模式：挂载后只显示电话图标，后台自动准备待机能力
- 调试模式门禁：只有 `debug=true` 且 `accessToken` 已通过服务端校验时，才展示调试面板