vuecli3typeScript-腾讯ai接口前端鉴权做效果

4次阅读

共计 4816 个字符,预计需要花费 13 分钟才能阅读完成。

前言

TypeScript 是一个 js 的超级,提供了 类型系统 和 es6 的支持,它是由微软开发,第一个版本发布于 2012 年 10 月,经多次更新,现已成为前端社区中不可忽视的力量,并且已经在微软内部广泛应用,google 的 angular2 也使用了 TypeScript 的开发语言,这也就是我们为什么学习 ts 的背景。

我们常用的 vue 框架也支持了使用 typeScript 开发,今天我们就来学习一下如何使用 vue-cli3+typeScript 开发一个简单项目,最近在研究腾讯的 ai 接口,完成一个简单的 demo,话不多少,上代码

1、创建项目

1、安装 vue-cli3, 检查版本,创建项目,已经全局安装过 vue-cli3 的直接创建项目即可,跟之前一样

npm install -g @vue/cli
vue --version
vue create my-ts-ai

2、需要注意的是第一次使用 ts 的,可以选择 Manually select feature 来自由选择功能,常用的有 vuex、vue-router、CSS Pre-processors 等,我们一定要把 typescript 勾上,就可以回车进入下一步了。PS:勾选的操作是按空格键。
需要注意,选择格式化检查的,需要选择 TSlint, 否则写 ts 会标红报错

3、创建成功之后,执行启动命令:npm run serve; 启动之后就可以访问本地项目、用 ts 编写代码了

2、vue-property-decorator

这是一个涵盖了 vue 的一些对象的集合,我们可以从这里取一些东西出来

import {Component, Prop, Vue, Watch} from 'vue-property-decorator';

取出来的这几个属性,分别是 组件定义 Component,父组件传递过来的参数Prop,原始 vue 对象Vue,数据监听对象Watch。还包括这里没有列举出来的ModelEmitInjectProvide,可以自己尝试下。
我们看一下常用的属性 prop、watch 一般写法
prop;
@Prop() private msg!: string;
watch:

// watch
  @Watch('active')
  private chageActive(newVal: string, oldVal: string) {console.log(`change txt: ${oldVal} to ${newVal}`);
  }
  @Watch('sticker')
  private chageSticker(newVal: string, oldVal: string) {console.log(`change txt: ${oldVal} to ${newVal}`);
  }

data:

// data
  private num: number = 0;
  private appId: number = 2140682408;
  private appKay: string = '3gP0QJTqC3j8qP6M';
  private imgBase64: string = '';
  private effectImg: string = '';

methods:

private choose(id: number, index: number) {
    this.sticker = id;
    this.active = index;
  }
  private postData(url: string, params: object) {
    const self: IParams = this;
    axios.post(url, qs.stringify(params), {headers: {'Content-Type': 'application/x-www-form-urlencoded'},
    }).then((response) => {console.log(response.data);
        if (response.data.ret === 0) {self.effectImg = 'data:image/jpeg;base64,' + response.data.data.image;}
    }).catch((error) => {console.log(error);
    });
  }

computed:

// computed
  get getMsg() {return this.msg + '11111';}
  get testTxt() {return this.$store.state.testTxt;}

3、vuex 的使用

在 store 里写法基本不变只要遵循 ts 的规则即可;
主要是说一下使用的时候的注意事项,话不多说直接上代码
引如

// 使用 vuex
import {
  State,
  Getter,
  Action,
  Mutation,
  namespace,
} from 'vuex-class';
const userModule = namespace('user')

声明

@State('testNum')  public testNum!: any;
  @Action('UPDATA_CHANGE_LOGIN') public UPDATA_CHANGE_LOGIN!: Function;
  @Mutation('CHANGE_LOGIN') public CHANGE_LOGIN!: Function;
  @userModule.State('firstName') public firstName!: string;
  @userModule.State('lastName') public lastName!: string;
  @userModule.Mutation('UPDATE_FIRST_NAME') public UPDATE_FIRST_NAME!: Function

然后像以前那样使用即可;

以上是我写的使用 typeScript、vue-cli3 框架编写的 demo 的重点;

下面主要说一下前端使用腾讯 ai 接口做一些效果;
关于注册、创建应用这些可以自己在网站尝试

1、接口鉴权

前端是没有权限直接调用接口鉴权的,因为有跨域问题,一般需要后台配合,所以以下这些代码可以使用 nodejs 开发;
因为是在 vue 框架下做的开发,vue 帮助我们做了服务器代理,所以我们可以在本地配置代理服务器,看下效果,同时了解基本的步骤,后续使用 nodejs 做接口鉴权;话不多少上代码
主要是签名算法,遵循腾讯的签名算法规则 详见 https://ai.qq.com/doc/auth.shtml
签名算法步骤

  1. 将 <key, value> 请求参数对按 key 进行 字典升序 排序,得到有序的参数对 列表 N
  2. 将列表 N 中的参数对按 URL 键值对的格式 拼接成字符串,得到 字符串 T (如:key1=value1&key2=value2),URL 键值拼接过程 value 部分需要 URL 编码,URL 编码算法用大写字母,例如 %E8,而不是小写 %e8
  3. 将应用密钥以 app_key 为键名,组成 URL 键值拼接到字符串 T 末尾,得到 字符串 S (如:key1=value1&key2=value2&app_key= 密钥)
  4. 对字符串 S 进行 MD5 运算,将得到的 MD5 值所有字符转换成大写,得到接口 请求签名
private postPurikura() { // 调用大头贴的接口,参数详见腾讯开放平台 apihttps://ai.qq.com/doc/facesticker.shtml
    const params: IParams = {
      app_id: this.appId,
      time_stamp: parseInt((new Date().getTime() / 1000).toString(), 10),
      nonce_str: Math.random().toString().substr(3, 8) + Date.now().toString(36),
      image: this.imgBase64,
      sticker: this.sticker,
    };
    const sign = this.getSign(params, this.appKay); // 签名算法,遵循腾讯的签名算法规则 详见 https://ai.qq.com/doc/auth.shtml
    params.sign = sign;
    this.postData(apis.facesticker, params);
  }
private getSign(params: any, appkey: string) {const sortArr = Object.keys(params).sort((x: string, y: string): number => {return x.localeCompare(y, 'zh-Hans-CN', { sensitivity: 'accent'});
    }); 
    const newParams: IParams = {};
    sortArr.forEach((ele: string) => {newParams[ele] = params[ele];
    });// 请求参数对按 key 进行 ** 字典升序 ** 排序
    console.log(newParams);
    let url: string = '';
    Object.keys(newParams).forEach((key: string, i) => {if (newParams[key] !== '') {url += key + '=' + encodeURIComponent(newParams[key]) + '&';
      }
    });
    url += 'app_key=' + appkey; // 列表 N 中的参数对按 **URL 键值对的格式 ** 拼接成字符串,并将应用密钥以 app\_key 为键名,组成 URL 键值拼接到字符串 T 末尾,得到 ** 字符串 S **(如:key1=value1&key2=value2&app\_key= 密钥)
    const md5url = md5(url); // 对字符串 S 进行 MD5 运算
    const sign = md5url.toUpperCase(); // 的 **MD5 值所有字符转换成大写 **,得到接口 ** 请求签名 **
    console.log(sign);
    return sign;
  }

ts 书写过程中的注意事项

1、对象要创建接口;直接定义类型为 object,必须是已经确定的属性和值,如果新加属性,则会标红提示没有这个属性值;创建接口的方式如下

interface IParams {[x: string]: any
} // 使用的时候,就可以给 reader 随意增加属性
`const reader: IParams = new FileReader();`

2、parseInt要传 2 个参数,不然会报 Missing radix parameter,这个意思是缺少一个基数根
parseInt(string, radix) 函数的,这个函数一共需要两个参数:

  • string:必需。要被解析的字符串。
  • radix:可选。表示要解析的数字的基数。该值介于 2 ~ 36 之间。如果省略该参数或其值为 0,则数字将以 10 为基础来解析。如果它以“0x”或“0X”开头,将以 16 为基数。如果该参数小于 2 或者大于 36,则 parseInt() 将返回 NaN。

3、控制台报错 Calls to ‘console.log’ are not allowed. 不被允许写入 console, 要在 tslint.json 中的 rules 中加入 “no-console”: false。方便测试
4、注意和 js 做区分,一句代码结束要加;, 对象的最后一个属性要加,
5、如果 VSCode 编辑器有警告提示,比如:
Experimental support for decorators is a feature that is subject to change in a future release. Set the 'experimentalDecorators' option to remove this warning.
可以把工作区其他的项目移除,或者把本项目拖动到工作区的首位,或者在把本项目的 tsconfig.json 复制到工作区首位的项目的根目录下,重启编辑器,有比较大的概率可以解决警告提示。

正文完
 0