readme_en.md · jltxseo/CoreSpeechKit-SampleCode-ArkTS-KitASRDemo

# Speech Recognition

## Overview

This sample code illustrates how to use the speech recognition capability provided by Core Speech Kit.

In this sample code, audio streams will be converted into text.

You need to use **@kit.CoreSpeechKit.d.ts**, which contains the APIs for speech recognition.

## Preview

How to use:

1. On the home screen of a mobile phone, tap **asrDemo** to start the app.
2. Tap **CreateEngine** to initialize the capability.
3. Tap **startRecording** to start recognition.
4. Tap **audioTotext** to write streams for recognition. You need to prepare audio streams.
   If the audio streams are obtained by reading the audio file in the demo, run the following commands first:
   hdc file send 001.pcm /data/app/el2/100/base/com.huawei.hms.asrdemo/haps/entry/files
   hdc shell chmod 777 -R /data/app/el2/100/base/com.huawei.hms.asrdemo/haps/entry/files/001.pcm 
   Import the audio information in PCM format to the sandbox path of this demo.
   Tap **audioTotext** to obtain the audio information from the audio file and write the information.
5. Tap **finish** and other buttons to control the recognition event.
6. Tap **queryLanguagesCallback/queryLanguagesPromise** to query the supported languages and timbres.

### Project Directory
```
├─entry/src/main/ets                         // Code area
│  ├─entryability
│  │  └─EntryAbility.ets       
│  └─pages
│     ├─AsrConstants.ts                      // Constants
│     ├─AudioCapturer.ts                     // Recorder 1
│     ├─FileCapturer.ts                      // Recorder 2
│     ├─ICapturerInterface.ts                // Recorder API class
│     ├─Index.ets                            // Main page
│     └─Util.ts                              // Utility class
├─entry/src/main/resources                   // App resource directory
└─screenshots                                // Screenshots
```

## How to Implement

This example shows the APIs defined in **@kit.CoreSpeechKit.d.ts**.
~~~
* createEngine(createEngineParams: CreateEngineParams, callback: AsyncCallback<SpeechRecognizerEngine>): void;
* createEngine(createEngineParams: CreateEngineParams): Promise<SpeechRecognizerEngine>;
* setListener(listener: RecognizerListener): void;
* queryLanguages(params: LanguageQuery, callback: AsyncCallback<Array<string>>): void;
* queryLanguages(params: LanguageQuery): Promise<Array<string>>;
* startListening(params: StartParams): void;
* writeAudio(sessionId: string, audio: Uint8Array): void;
* finish(sessionId: string): void;
* cancel(sessionId: string): void;
* shutdown(): void;
~~~
Before using the service, you need to import **speechRecognizer**.
Call APIs such as **writeAudio** to pass the audio to be recognized, obtain the recognition result, and view logs. For details, please refer to **entry/src/main/ets/pages/Index.ets**.

## Required Permissions

ohos.permission.MICROPHONE

## Dependencies

N/A

## Constraints

1. The sample app is only supported on Huawei phones, tablets, and 2-in-1 devices with standard systems.
2. The HarmonyOS version must be HarmonyOS NEXT Developer Beta1 or later.
3. The DevEco Studio version must be DevEco Studio NEXT Developer Beta1 or later.
4. The HarmonyOS SDK version must be HarmonyOS NEXT Developer Beta1 or later.

jltxseo/CoreSpeechKit-SampleCode-ArkTS-KitASRDemo

简介

发行版

贡献者

近期动态

jltxseo/CoreSpeechKit-SampleCode-ArkTS-KitASRDemo .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

jltxseo/CoreSpeechKit-SampleCode-ArkTS-KitASRDemo