---
title: initPlayerWidgets
summary: 介绍 initPlayerWidgets API 用于批量插入播放器 Widget 组件及配置选项。
---

# initPlayerWidgets

调用此 api，用于给播放器插入现组件上所有实现的 **Widget**。

```tsx
type initPlayerWidgets = (instance, options: Options) => void
```

## 如何使用
```jsx
import { useEffect } from 'react'
import { useCtx, IPCPlayerIntegration, Features } from '@ray-js/ipc-player-integration';
import '@ray-js/ipc-player-integration/iconfont/iconfont.css';
 
function Page() {

  const deviceId = '1234567890xxxxxx';
  const instance = useCtx({
    devId: deviceId,
  });

  useEffect(() => {
    // 初始化 Widget
    // 调用此方法后将为播放器添加当前组件上所有使用到的 Widget
    Features.initPlayerWidgets(instance, Options);
  }, [])

  return (
    <IPCPlayerIntegration
      instance={instance}
      devId={deviceId}
    />
  )
}
```

## Options
| 参数名 | 类型 | 含义 |
|-------|----- |-----|
| hideHorizontalMenu | `bool` | 默认 false，是否隐藏进入横屏的按钮 |
| hideScreenShotMenu | `bool` | 默认 false，是否隐藏截图按钮 |
| hideRecordVideoMenu | `bool` | 是否隐藏录制按钮 |
| directionControlProps | `object` | 方向控制组件接收的 props |