From 5edc1b77321380e4710e28c5dea2be3812d39418 Mon Sep 17 00:00:00 2001
From: 游雁 <zhifu.gzf@alibaba-inc.com>
Date: 星期一, 08 五月 2023 22:36:07 +0800
Subject: [PATCH] websocket docs

---
 funasr/runtime/python/grpc/proto/paraformer.proto |   14 --------------
 funasr/runtime/python/websocket/README.md         |   33 ++++++++++++++++++---------------
 2 files changed, 18 insertions(+), 29 deletions(-)

diff --git a/funasr/runtime/python/grpc/proto/paraformer.proto b/funasr/runtime/python/grpc/proto/paraformer.proto
index b221ee2..6c336a8 100644
--- a/funasr/runtime/python/grpc/proto/paraformer.proto
+++ b/funasr/runtime/python/grpc/proto/paraformer.proto
@@ -1,19 +1,5 @@
-// Copyright (c) 2021 Ximalaya Speech Team (Xiang Lyu)
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//   http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 syntax = "proto3";
 
-option java_package = "ex.grpc";
 option objc_class_prefix = "paraformer";
 
 package paraformer;
diff --git a/funasr/runtime/python/websocket/README.md b/funasr/runtime/python/websocket/README.md
index 4764232..d77bd62 100644
--- a/funasr/runtime/python/websocket/README.md
+++ b/funasr/runtime/python/websocket/README.md
@@ -1,6 +1,6 @@
 # Service with websocket-python
 
-This is a demo using funasr pipeline with websocket python-api. 
+This is a demo using funasr pipeline with websocket python-api. It supports the offline, online, offline/online-2pass unifying speech recognition. 
 
 ## For the Server
 
@@ -22,6 +22,7 @@
 
 ### Start server
 #### ASR offline server
+##### API-reference
 ```shell
 python ws_server_offline.py \
 --port [port id] \
@@ -30,12 +31,13 @@
 --ngpu [0 or 1] \
 --ncpu [1 or 4]
 ```
-`e.g.`
+##### Usage examples
 ```shell
 python ws_server_offline.py --port 10095 --asr_model "damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-pytorch"
 ```
 
 #### ASR streaming server
+##### API-reference
 ```shell
 python ws_server_online.py \
 --port [port id] \
@@ -43,12 +45,13 @@
 --ngpu [0 or 1] \
 --ncpu [1 or 4]
 ```
-`e.g.`
+##### Usage examples
 ```shell
 python ws_server_online.py --port 10095 --asr_model_online "damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-online"
 ```
 
 #### ASR offline/online 2pass server
+##### API-reference
 ```shell
 python ws_server_2pass.py \
 --port [port id] \
@@ -58,7 +61,7 @@
 --ngpu [0 or 1] \
 --ncpu [1 or 4]
 ```
-`e.g.`
+##### Usage examples
 ```shell
 python ws_server_2pass.py --port 10095 --asr_model "damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-pytorch"  --asr_model_online "damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-online"
 ```
@@ -73,7 +76,7 @@
 ```
 
 ### Start client
-
+#### API-reference
 ```shell
 python ws_client.py \
 --host [ip_address] \
@@ -85,38 +88,38 @@
 --output_dir [if set, write the results to output_dir] \
 --send_without_sleep [only set for offline]
 ```
-
-#### ASR offline client
-##### Recording from mircrophone
+#### Usage examples
+##### ASR offline client
+###### Recording from mircrophone
 ```shell
 # --chunk_interval, "10": 600/10=60ms, "5"=600/5=120ms, "20": 600/12=30ms
 python ws_client.py --host "0.0.0.0" --port 10095 --chunk_interval 10 --words_max_print 100
 ```
-##### Loadding from wav.scp(kaldi style)
+###### Loadding from wav.scp(kaldi style)
 ```shell
 # --chunk_interval, "10": 600/10=60ms, "5"=600/5=120ms, "20": 600/12=30ms
 python ws_client.py --host "0.0.0.0" --port 10095 --chunk_interval 10 --words_max_print 100 --audio_in "./data/wav.scp" --send_without_sleep --output_dir "./results"
 ```
 
-#### ASR streaming client
-##### Recording from mircrophone
+##### ASR streaming client
+###### Recording from mircrophone
 ```shell
 # --chunk_size, "5,10,5"=600ms, "8,8,4"=480ms
 python ws_client.py --host "0.0.0.0" --port 10095 --chunk_size "5,10,5" --words_max_print 100
 ```
-##### Loadding from wav.scp(kaldi style)
+###### Loadding from wav.scp(kaldi style)
 ```shell
 # --chunk_size, "5,10,5"=600ms, "8,8,4"=480ms
 python ws_client.py --host "0.0.0.0" --port 10095 --chunk_size "5,10,5" --audio_in "./data/wav.scp" --words_max_print 100 --output_dir "./results"
 ```
 
-#### ASR offline/online 2pass client
-##### Recording from mircrophone
+##### ASR offline/online 2pass client
+###### Recording from mircrophone
 ```shell
 # --chunk_size, "5,10,5"=600ms, "8,8,4"=480ms
 python ws_client.py --host "0.0.0.0" --port 10095 --chunk_size "8,8,4" --words_max_print 10000
 ```
-##### Loadding from wav.scp(kaldi style)
+###### Loadding from wav.scp(kaldi style)
 ```shell
 # --chunk_size, "5,10,5"=600ms, "8,8,4"=480ms
 python ws_client.py --host "0.0.0.0" --port 10095 --chunk_size "8,8,4" --audio_in "./data/wav.scp" --words_max_print 10000 --output_dir "./results"

--
Gitblit v1.9.1