在使用 SDK 其它功能前，必须先进行初始化。本文中将详细说明 IM UIKit 初始化的方法。如您首次使用 IM UIKit，建议您先阅读集成 IM UIKit。

前提条件

• 已导入组件。
• 已注册云信 IM 账号，获取 accid 和 token。

注意事项

• 在应用生命周期内，只需初始化一次。
• Provider 内部管理 IM UIKit 与 IM 服务端的连接与断连。如果需要手动连接和断连，请参考登录登出。
• Provider 内部管理着全局的状态，一般无需开发者关心。如需访问上下文，请参考全局上下文。

初始化说明

如果您尚未集成过网易云信 NIM SDK，可采用如下方式对 IM UIKit 进行初始化。

初始化参数说明

• 给消息加上推送相关参数的示例代码如下，在localOptions中的sendMsgBefore中获取到发送前的消息体，在消息体上挂载相关参数：

  // 本地默认行为参数
    const localOptions = {
      addFriendNeedVerify,
      sendMsgBefore:(options:any ) => {
        const pushInfo = {
          needPushNick: '',
          isPushable: true,
          pushContent: '',
          pushPayload: JSON.stringify({channel_id:'xxxxx'}),
          apns: {
            accounts:'',
            content: '',
            forcePush: '',
          },      
        }
        options = {
          ...options,
          ...pushInfo
          }  
        return options  
      }
    }
    
  <Provider
      //...
      localOptions={localOptions}
    >
      <IMApp/>
    </Provider>
  

• 可以在发送消息时，设置将当前消息进行抄送。在 sendMsgBefore进行配置，将 env 字段挂载在发送前的消息体上即可。

  // 本地默认行为参数
    const localOptions = {
      addFriendNeedVerify,
      sendMsgBefore:(options, type) => {
        const env = 'xxxx'
        return { ...options, env }
      },
    }
    
  <Provider
      //...
      localOptions={localOptions}
    >
      <IMApp/>
    </Provider>
  

初始化示例代码

import React from 'react'
import { Provider } from '@xkit-yx/im-kit-ui'

const App = () => {
  const initOptions = {
    appkey: '', //传入您的App Key
    account: '', // 传入您的云信IM账号
    token: '', // 传入您的Token
    debugLevel: 'debug',//设置日志level
    // 参考 NIM SDK 的 initOptions
  }

  return (
    <Provider initOptions={initOptions} sdkVersion={1}>
      <div className="app">……</div>
    </Provider>
  )
}