RongRTCAdapter

为融云 RTCLib v3 用户提供的桥接方案，以便于用户最小化改动的情况下可以直接升级至 RTCLib v5 - @rongcloud/plugin-rtc

$3

* 使用 RongIMLib v2 的开发者需升级至 RongIMLib v2.8 以上
``shell
npm i @rongcloud/imlib-v2
`
* 使用 RongIMLib v3 及 v4 的开发者需升级至 RongIMLib v4.3 以上
`shell
npm i @rongcloud/imlib-v4
`
* 需安装 RTCLib v5 版本
`shell
npm i @rongcloud/plugin-rtc
`

$3

`shell
npm i @rongcloud/adapter-plugin-rtc
`

$3

以下列出的是相较于老版本 RongRTC-v3，使用 RongRTCAdapter 所需要进行的修改内容。

> 桥接层中的模块，多次初始化后仅最后一次的初始化回调数据有效

##### Init

`typescript
// 以 RongIMLib v2 举例
import { RongIMClient } from '@rongcloud/imlib-v2'
import { installer, RCRTCClient } from '@rongcloud/plugin-rtc'
import * as RongRTCAdapter from '@rongcloud/rtc-v3-adapter'

// IM 客户端初始化，此处以 IMLib 2.8 举例
const imClient = RongIMClient.init(appkey, null, { ...options })
// rtc v5 客户端初始化
const rtcClient: RCRTCClient = imClient.install(installer, { ...options })

// 初始化方式变更，不再使用 new RongRTC()，同时需要传递 RCRTCClient 实例
RongRTCAdapter.init({ client: rtcClient, bitrate, liveRole?, mode?, liveType? })

// 由于初始化方式变更，故模块获取方式也需要变更，现在直接通过 RongRTCAdapter 顶级变量获取
const { Room, Stream, Message, Device, Storage, StreamType, StreamSize，Mode, LiveType, ROLE } = RongRTCAdapter;

// 替换 rongRTC.changeLiveRole 接口
RongRTCAdapter.changeLiveRole(ROLE.AUCHOR)

// 反初始化，相当于原 rongRTC.destroy()
// 为避免内存泄露，使用该方法后，已初始化的所有功能模块将失效
RongRTCAdapter.destroy()
`

##### Room 模块

`typescript
//Room 模块初始化方式不变
const room = new Room({ id, ...options })

// 加入房间时不再需要传参
room.join(/{ id: 'userId' }/)
`

##### Stream

`typescript
// Stream 模块初始化方式不变
const stream = new Stream({ ...options })

// 发布资源时不再需要传递当前用户 id
stream.publish({ /id: '',/ stream: { tag, type, mediaStream }})

// 发布小流时，需先保证发布了大流数据
stream.publish({ stream: { tag, type, mediaStream, size }})

// 取消发布资源时不再需要传递当前用户 id
stream.unpublish({ /id: '',/ stream: { tag, type }})

// 切换大小流 不再需要传递 stream.type 字段
stream.resize({
id: '',
stream: {
tag: '',
size: StreamSize.MAX,
// type: StreamType.AUDIO_AND_VIDEO
}
})
`

##### Monitor 模块

`typescript
new Monitor({
stats ({ sender, received }) {
// 废弃 sender.packetsLost

// 以下为当个流状态数据的改动
// const track: ITrackStat = sender.tracks[0]

// 废弃：track.trackState
// 废弃：track.codecImplementationName
// 废弃：track.googFirsReceived
// 废弃：track.googPlisReceived
// 废弃：track.googNacksReceived
// 废弃：track.googRenderDelayMs
// 废弃：track.samplingRate
// 废弃：track.googCodecName
}
});
``

$3

##### RongRTCAdapter（index.ts）

* ✅ StreamType
* ✅ StreamSize
* ✅ Mode
* ✅ ROLE
* ✅ LiveType
* ✅ LayoutMode
* ✅ RenderMode
* ✅ Resolution
* ✅ RongRTCVideoFps
* ✅ StorageType
---
* ✅ Room
* ✅ Stream
* ✅ Message
* ✅ Device
* ✅ Storage
* ✅ Monitor
* ✅ Report
---
* ✅ init()
* ✅ destroy()
* ✅ changeLiveRole()

##### Room

* ✅ constructor()
* ✅ join()
* ✅ leave()
* ✅ get()
* ✅ getSessionId ()
* ✅ getStats ()

##### Stream

* ✅ constructor()
* ✅ get()
* ✅ publish()
* ✅ unpublish()
* ✅ subscribe()
* ✅ unsubscribe()
* ✅ video.disable()
* ✅ video.enable()
* ✅ audio.mute()
* ✅ audio.ummute()
* ✅ resize()
---
* ✅ addPublishStreamUrl()
* ✅ removePublishStreamUrl()
* ✅ setMixConfig()

##### Device

* ✅ constructor()
* ✅ get()

##### Monitor

* ✅ constructor()

##### Report

* ✅ constructor()
* ✅ start()

##### Message

* ✅ constructor()
* ✅ send()

##### Storage

* ✅ constructor()
* ✅ set()
* ✅ get()
* ✅ remove()