# 快速开始

## 1. 概述

利用assistantSDK可以与CC视频直播系统进行对接，灵活调用直播的视频、文档、聊天、问答等模块，在您的网页中实现自定义样式界面展示助教直播。

资源下载

下载地址：
[https://dl.csslcloud.net/live/sdk/web/assistant/v1.0.0/assistantDemo.zip](https://dl.csslcloud.net/live/sdk/web/assistant/v1.0.0/assistantDemo.zip)

> 压缩包内包含直播助教的SDK文件以及相关说明文档、demo
> SDK最新版本为 1.0.0

在线访问地址：
[https://dl.csslcloud.net/live/sdk/web/assistant/v1.0.0/demo/login/index.html](https://dl.csslcloud.net/live/sdk/web/assistant/v1.0.0/demo/login/index.html)

浏览器支持

```
- Chrome  60+
- Firefox  52+
- IE9+
- Edge
- Safari  10+
```

### 1.1 功能特性

websdk目前包含直播播放器、文档功能、聊天功能、问答功能、用户列表 以及公告、广播、随堂测、抽奖等互动功能

#### 1.1.1 主要功能描述


|     |                                      |
| --- | ------------------------------------ |
| 功能  | 描述                                   |
| 播放器 | 多线路 纯音频模式                            |
| 聊天  | 支持公聊、私聊 支持聊天置顶 支持发送自定义表情 支持用户禁言      |
| 问答  | 支持课堂问答                               |
| 文档  | 支持文档展示                               |
| 互动  | 支持发布/管理公告、广播 支持发布随堂测 支持发布抽奖 支持设置用户基数 |


## 2.开发准备

由于浏览器的安全策略对除 127.0.0.1 以外的 HTTP 地址作了限制，websdk 仅支持 HTTPS 协议或者 [http://localhost（http://127.0.0.1），故websdk的开发环境需做以下准备](http://localhost（http://127.0.0.1），故websdk的开发环境需做以下准备)

### 2.1 开发环境

1.浏览器 : chrome65+浏览器
2.网络协议 : https 或 localhost本机环境
3.账号权限：已经开通获得场景视频（原cc视频）开发者账号

## 3.快速集成

### 3.1 引入直播SDK

#### 3.1.1 引入 jQuery

 直播SDK依赖于jQuery，请自行引入 jQuery 库，建议使用1.9.X版本 。

```
<script src="//view.csslcloud.net/js/jquery-1.9.0.min.js" type="text/javascript"></script>
```

#### 3.1.2 引入 JS SDK

```
<script src="//xxx.net/xxx/assistantSDK.js" type="text/javascript"></script>
```

verison为版本号

### 3.2  创建视频模块元素、文档模块元素

```
<!-- 视频模块 -->
<div id="livePlayer"></div>
<!-- 文档模块 -->
<div id="drawPanel"></div>
```

### 3.3 初始化

```javascript
<script type="text/javascript">
    DWLive.init({
        userid: 'xxx',
        roomid: 'xxx',
        groupid: '',
        viewername: '助教',
        viewertoken: '123',
        debug: true,
        hdChat: true
    });
</script>
```

初始化参数说明


| 参数        | 说明                                                      |
| ----------- | --------------------------------------------------------- |
| userid      | 用户 id，不可为空                                         |
| roomid      | 直播间id，不可为空                                        |
| groupid     | 分组id，可为空                                            |
| viewername  | 用户名称，可为空                                          |
| viewertoken | 需要密码验证方式时，不可为空                              |
| debug       | 调试模式；true为开启；false为关闭                         |
| haChat      | 是否使用hdChat带UI的聊天室组件；true为使用；false为不使用 |


## 4. API查询

[API文档](web_live_sdk_apis.md)