# @dingdaoos/dingcloud-measuring-tools

> 计量工具JS-SDK

Latest version **1.1.0** (published 2022-11-21) · BSD 3-Clause license · 0 weekly downloads

## Install

```sh
npm install @dingdaoos/dingcloud-measuring-tools
pnpm add @dingdaoos/dingcloud-measuring-tools
yarn add @dingdaoos/dingcloud-measuring-tools
bun add @dingdaoos/dingcloud-measuring-tools
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2022-11-21 |
| First published | 2022-11-21 |
| Weekly downloads | 0 |
| License | BSD 3-Clause |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 6.4 MB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Author | dingdaoos |
| Maintainers | yaobb, zhanglibin8, boxup, dingdaoos-owner |
| Keywords | dingcloud, sdk |

## Links

- npm: https://www.npmjs.com/package/@dingdaoos/dingcloud-measuring-tools
- npm.io page: https://npm.io/package/@dingdaoos/dingcloud-measuring-tools

## Dependencies (3)

- [vue](https://npm.io/package/vue.md) ^2.6.11
- [core-js](https://npm.io/package/core-js.md) ^3.6.5
- [mammoth](https://npm.io/package/mammoth.md) ^1.5.1

## Recent versions

- 1.1.0 (latest) — 2022-11-21
- 1.0.0 — 2022-11-21

## README

# 计量工具JS-SDK


- 正确示例参见下方集成方法
### 集成方法
计量工具JS-SDK为您提供四种前端集成方式，无论您的项目采用何种开发模式，都可以找到您对应的集成方法。
1. ES6模块化导入
npm安装
```shell
npm install @dingdaoos/dingcloud-measuring-tools
```
- vue项目
```js
//vue项目：
//在main.js文件引用
import TOOLS_SDK from '@dingdaoos/dingcloud-measuring-tools'

//建议挂载在Vue的prototype上，方便全局使用，但这不是必须的，您可以根据需要按需引入到单个页面（在单页面import TOOLS_SDK from '@dingdaoos/dingcloud-measuring-tools'）
Vue.prototype.TOOLS_SDK = TOOLS_SDK;
//在需要调用sdk的页面：拓展功能示例
//getFlieData (该函数为异步函数)
//@param {object || string} file
//@returns {Object} {duration：1000, size：5000}
//file:  文件（file）|| 文件(URL)
//file如果为url时，遇到跨域需要提供源文件
//文件时长:(单位[duration]:S)：，文件大小:(单位[size]:Byte ，文本长度:（单位[length]:个）)
this.TOOLS_SDK.track.getFlieData(file).then(res=>{
  //res={duration:0,size:0,length:0}
})

//getBytesLength （获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：Byte）
this.TOOLS_SDK.track.getBytesLength(string)

//getWordsLength（获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：个）
this.TOOLS_SDK.track.getWordsLength(string)
```
- react项目
```js
//入口文件
import TOOLS_SDK from '@dingdaoos/dingcloud-measuring-tools'

//建议挂载在prototype上，方便全局使用，但这不是必须的，您可以根据需要按需引入到单个页面（在单页面import TOOLS_SDK from 'dingcloud-measuring-tools'）
import React from  'react'
React.Component.prototype.TOOLS_SDK = TOOLS_SDK;
//在需要调用sdk的页面：拓展功能示例
//getFlieData (该函数为异步函数)
//@param {object || string} file
//@returns {Object} {duration：1000, size：5000}
//file:  文件（file）|| 文件(URL)
//file如果为url时，遇到跨域需要提供源文件
//文件时长:(单位[duration]:S)：，文件大小:(单位[size]:Byte ，文本长度:（单位[length]:个）)
this.TOOLS_SDK.track.getFlieData(file).then(res=>{
  //res={duration:0,size:0,length:0}
})

//getBytesLength （获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：Byte）
this.TOOLS_SDK.track.getBytesLength(string)

//getWordsLength（获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：个）
this.TOOLS_SDK.track.getWordsLength(string)
```
- 其他框架项目引入方式同理

2. script形式同步导入
```html
<html>
    <head>
        <!-- 引入 -->
        <script src="https://js.dingcloud.com/web-sdk/1.0.0/dingcloud-measuring-tools.min.js" />
    </head>
</html>

<script>
//在需要调用sdk的页面：拓展功能示例
//getFlieData (该函数为异步函数)
//@param {object || string} file
//@returns {Object} {duration：1000, size：5000}
//file:  文件（file）|| 文件(URL)
//file如果为url时，遇到跨域需要提供源文件
//文件时长:(单位[duration]:S)：，文件大小:(单位[size]:Byte ，文本长度:（单位[length]:个）)
window.track.getFlieData(file).then(res=>{
  //res={duration:0,size:0,length:0}
})

//getBytesLength （获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：Byte）
window.track.getBytesLength(string)

//getWordsLength（获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：个）
window.track.getWordsLength(string)

</script>
```

3. CommonJs规范加载
- npm安装
```shell
npm install @dingdaoos/dingcloud-measuring-tools
```
- 引入方式
```js
//引入
const TOOLS_SDK = require("dingcloud-measuring-tools");
//在需要调用sdk的页面：拓展功能示例
//注：只获取图片size可以使用getImgSize函数
//getFlieData (该函数为异步函数)
//@param {object || string} file
//@returns {Object} {duration：1000, size：5000}
//file:  文件（file）|| 文件(URL)
//file如果为url时，遇到跨域需要提供源文件
//文件时长:(单位[duration]:S)：，文件大小:(单位[size]:Byte ，文本长度:（单位[length]:个）)
TOOLS_SDK.track.getFlieData(file).then(res=>{
  //res={duration:0,size:0,length:0}
})

//getBytesLength （获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：Byte）
TOOLS_SDK.track.getBytesLength(string)

//getWordsLength（获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：个）
TOOLS_SDK.track.getWordsLength(string)
```
4. AMD规范加载
- 引入方式
```js
requirejs(["https://js.dingcloud.com/web-sdk/1.0.0/dingcloud-measuring-tools.min.js"], function(TOOLS_SDK) { 
//在需要调用sdk的页面：拓展功能示例
//getFlieData (该函数为异步函数)
//@param {object || string} file
//@returns {Object} {duration：1000, size：5000}
//file:  文件（file）|| 文件(URL)
//file如果为url时，遇到跨域需要提供源文件
//文件时长:(单位[duration]:S)：，文件大小:(单位[size]:Byte ，文本长度:（单位[length]:个）)
TOOLS_SDK.track.getFlieData(file).then(res=>{
  //res={duration:0,size:0,length:0}
})

//getBytesLength （获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：Byte）
TOOLS_SDK.track.getBytesLength(string)
});

//getWordsLength（获取字符串长度）
//@param {string}
//@returns  {Number}
//获取字符串长度（单位：个）
TOOLS_SDK.track.getWordsLength(string)
```
## 计量工具JS-SDK历史版本
### 1.0.0
基础稳定版

---
_Source: https://npm.io/package/@dingdaoos/dingcloud-measuring-tools · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._