# jovo-client-web-vue > > To view this page on the Jovo website, visit https://v3.jovo.tech/marketplace/jovo-client-web-vue Latest version **3.6.2** (published 2022-07-28) · 0 weekly downloads ## Install ```sh npm install jovo-client-web-vue pnpm add jovo-client-web-vue yarn add jovo-client-web-vue bun add jovo-client-web-vue ``` ## Health **Score 25/100 (F)** — status: abandoned. Positive: has types; no vulnerabilities; high quality score. Warnings: low downloads; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 3.6.2 | | Published | 2022-07-28 | | First published | 2020-02-25 | | Weekly downloads | 0 | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 1 | | Unpacked size | 547.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Maintainers | jovotech | ## Links - npm: https://www.npmjs.com/package/jovo-client-web-vue - npm.io page: https://npm.io/package/jovo-client-web-vue ## Dependencies (1) - [jovo-client-web](https://npm.io/package/jovo-client-web.md) ^3.6.2 ## Recent versions - 3.6.2 (latest) — 2022-07-28 - 3.6.1 — 2022-02-17 - 3.6.0 — 2021-11-18 - 3.5.3 — 2021-05-10 - 3.5.2 — 2021-03-26 - 3.5.1 — 2021-02-22 - 3.5.0 — 2021-02-22 - 3.4.1 — 2021-02-09 - 3.4.0 — 2021-02-04 - 3.3.1 — 2021-01-27 - 3.3.0 — 2020-12-03 - 3.2.7 — 2020-11-25 - 3.2.6 — 2020-11-25 - 3.2.5 — 2020-11-25 - 3.2.4 — 2020-11-20 - … 46 more at https://npm.io/package/jovo-client-web-vue/versions ## README # Jovo Web Client - Vue > To view this page on the Jovo website, visit https://v3.jovo.tech/marketplace/jovo-client-web-vue Build voice and conversational experiences for the web with Vue.js and Jovo. You can find the vanilla JavaScript web client here: [Jovo Web Client](https://v3.jovo.tech/marketplace/jovo-client-web). - [Introduction](#introduction) - [Installation](#installation) - [Configuration](#configuration) - [Sending a Request to the Jovo App](#sending-a-request-to-the-jovo-app) - [Recording Voice Input](#recording-voice-input) - [Event Listeners](#event-listeners) - [SpeechRecognizer](#speechrecognizer) ## Introduction ![Jovo Client and Jovo Web Platform](https://raw.githubusercontent.com/jovotech/jovo-framework/master/jovo-platforms/jovo-platform-web/img/jovo-client-platform-communication.png 'How Jovo Core Platform communicates with clients like web apps') [Jovo Clients](https://v3.jovo.tech/marketplace/tag/clients) are used as a frontend that collects user input. This input (e.g. speech or text) is then passed to the [Jovo Web Platform](https://v3.jovo.tech/marketplace/jovo-platform-web) that handles the conversational logic. The "Jovo for Web" client can be used on websites and web apps built with Vue.js. It comes with helpful features that make it easier to capture speech input, detect when a user stops speaking, and display information that is returned from the Jovo app. The client is open source and fully customizable. You can check out one of these starter templates to get a first impression of how it looks like: - [Standalone Voice Experience](https://github.com/jovotech/jovo-starter-web-standalone) - [Voice Overlay](https://github.com/jovotech/jovo-starter-web-overlay) - [Chat Widget](https://github.com/jovotech/jovo-starter-web-chatwidget) - [Embedded Chat](https://github.com/jovotech/jovo-starter-web-embeddedchat) ### Installation This package is a plugin for Vue.js and does not work without it. `vue` is a peer-dependency of this package and therefore needs to be installed as well. ```sh $ npm install jovo-client-web-vue vue ``` ## Configuration You can configure the client like this: ```javascript Vue.use(JovoClientWebVue, { url: WEBHOOK_URL, client: { debugMode: true, locale: 'en-US', defaultInputType: 'voice', }, }); ``` ## Sending a Request to the Jovo App To send a request to the Jovo app, you can use the `$client` object: ```js this.$client.createRequest({ type: RequestType.Text, body: { 'Hello World' } }).send(); ``` ## Recording Voice Input To record the user's voice input and automatically send it to the Jovo app, you can use the `startInputRecording()` and `stopInputRecording()` methods. Here's a sample implementation of a microphone button that will record the audio as long as the button is pushed down and send the audio as soon as it's released: ```html ``` ```js async onMouseDown(event: MouseEvent | TouchEvent) { if (!this.$client.isInitialized) { await this.$client.initialize(); } if (this.$client.isRecordingInput) { return; } if (event instanceof MouseEvent) { window.addEventListener('mouseup', this.onMouseUp); } else { window.addEventListener('touchend', this.onMouseUp); } await this.$client.startInputRecording(); } private onMouseUp(event: MouseEvent | TouchEvent) { window.removeEventListener('mouseup', this.onMouseUp); this.$client.stopInputRecording(); } ``` ## Event Listeners You can use listeners to react to events of the Jovo app from within your Vue component ```js import { ClientEvent } from 'jovo-client-web-vue'; import { Component, Vue } from 'vue-property-decorator'; @Component({ name: 'overlay' }) export default class Overlay extends Vue { mounted() { this.$client.on(ClientEvent.Request, this.onRequest); this.$client.on(ClientEvent.Response, this.onResponse); this.$client.on(ClientEvent.Action, this.onAction); } beforeDestroy() { this.$client.off(ClientEvent.Request, this.onRequest); this.$client.off(ClientEvent.Response, this.onResponse); this.$client.off(ClientEvent.Action, this.onAction); } ``` The following event types are supported: | Name | Description | Parsed Parameters | | :--------- | :--------------------------------------------------------------------------- | :---------------------------- | | `Request` | triggered when the request is received by the Jovo app. Parses the request | `(req: WebRequest)` | | `Response` | triggered when the Jovo app sends out the response. Parses the response | `(res: WebResponse)` | | `Action` | triggered when the Jovo app's response contains an action. Parses the action | `(action: Action)` | | `Reprompt` | triggered when a reprompt is triggered. Parses the reprompt actions | `(repromptActions: Action[])` | ### SpeechRecognizer The SpeechRecognizer uses Google Chrome's ASR and has its own set of listeners: ```js import { SpeechRecognizerEvent } from 'jovo-client-web-vue'; import { Component, Vue } from 'vue-property-decorator'; @Component({ name: 'overlay' }) export default class Overlay extends Vue { mounted() { this.$client.$speechRecognizer.on( SpeechRecognizerEvent.SpeechRecognized, this.onSpeechRecognized, ); } beforeDestroy() { this.$client.$speechRecognizer.off( SpeechRecognizerEvent.SpeechRecognized, this.onSpeechRecognized, ); } ``` | Name | Description | Parsed Parameters | | :----------------- | :----------------------------------------------------------------------- | :-------------------------------- | | `StartDetected` | triggered when the speech input has started | `()` | | `SpeechRecognized` | triggered when the speech input has been collected | `(event: SpeechRecognitionEvent)` | | `End` | triggered when the SpeechRecognizer has ended (after `SpeechRecognized`) | `(event: SpeechRecognitionEvent)` | | `Timeout` | triggered when the SpeechRecognizer has timed out | `()` | | `SilenceDetected` | triggered when the SpeechRecognizer detected silence | `()` | | `Error` | triggered when the SpeechRecognizer encountered an error | `(error: Error)` | The `AudioHelper` class can be used to get the transcript from the `SpeechRecognizerEvent`: ```js import { AudioHelper } from 'jovo-client-web-vue'; //... onSpeechRecognized(event: SpeechRecognitionEvent) { this.inputText = AudioHelper.textFromSpeechRecognition(event); } ``` --- _Source: https://npm.io/package/jovo-client-web-vue · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._