English | 简体中文

Usage & Demo

demos could be found here: https://github.com/EnochGao/ngx-tencent-im/.

Installation

npm install ngx-tencent-im --save

Add package to NgModule imports:

import { TencentTimModule } from 'ngx-tencent-im';

@NgModule({
  ...
    TencentTimModule.forRoot({
      level: 4,
      sdkAppId: xxxxxxx, // <--- your im app id
      oversea: true // <--- support oversea
    }),
  ...
})

Add component to your page:

<ngx-tencent-tim (message)="messageTip($event)"></ngx-tencent-tim>

You will need to add css in angular.json:

• angular.json

            "assets": [
              ...
              {
                "glob": "**/*",
                "input": "./node_modules/@ant-design/icons-angular/src/inline-svg/",
                "output": "/assets/"
              }
            ],
            "styles": [
              ...
              "node_modules/ng-zorro-antd/ng-zorro-antd.min.css",
              "node_modules/ngx-tencent-im/assets/icon/iconfont.css",
              "node_modules/ngx-tencent-im/assets/icon/tim.css"
            ],

How to build lib for development

First time:

git clone https://github.com/enochgao/ngx-tencent-im.git
cd ngx-tencent-im
npm install
ng build ngx-tencent-im
npm start

Compatibility

The only three dependencies are Angular , ng-zorro-antdand NGRX. Here is the versions compatibility list:

| ngx-tencent-im | Angular | NG-ZORRO | ngrx | | -------------- | --------------- | -------- | ------- | | 0.0.1 | 11.x.x - 12.x.x | ^11.4.1 | ^12.0.0 | | 0.0.6 | 13.x.x- | ^13.0.0 | ^13.0.0 |

Contribution

All contributions very welcome! And remember, contribution is not only PRs and code, but any help with docs or helping other developers to solve issues are very appreciated! Thanks in advance!

Other

Function is improving the development, the current implementation of single chat, group chat...