From 420deca6146c433f9521b43a57d1f10200678db2 Mon Sep 17 00:00:00 2001 From: 游雁 <zhifu.gzf@alibaba-inc.com> Date: 星期四, 25 五月 2023 20:08:57 +0800 Subject: [PATCH] websocket docs --- funasr/runtime/python/websocket/README.md | 55 ++++++++++++------------------------------------------- 1 files changed, 12 insertions(+), 43 deletions(-) diff --git a/funasr/runtime/python/websocket/README.md b/funasr/runtime/python/websocket/README.md index f489bac..e19c00c 100644 --- a/funasr/runtime/python/websocket/README.md +++ b/funasr/runtime/python/websocket/README.md @@ -21,43 +21,10 @@ ``` ### Start server -#### ASR offline server -##### API-reference -```shell -python ws_server_offline.py \ ---port [port id] \ ---asr_model [asr model_name] \ ---punc_model [punc model_name] \ ---ngpu [0 or 1] \ ---ncpu [1 or 4] \ ---certfile [path of certfile for ssl] \ ---keyfile [path of keyfile for ssl] -``` -##### 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] \ ---asr_model_online [asr model_name] \ ---ngpu [0 or 1] \ ---ncpu [1 or 4] \ ---certfile [path of certfile for ssl] \ ---keyfile [path of keyfile for ssl] -``` -##### 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 \ +python wss_srv_asr.py \ --port [port id] \ --asr_model [asr model_name] \ --asr_model_online [asr model_name] \ @@ -69,7 +36,7 @@ ``` ##### 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" +python wss_srv_asr.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" ``` ## For the client @@ -84,7 +51,7 @@ ### Start client #### API-reference ```shell -python ws_client.py \ +python wss_client_asr.py \ --host [ip_address] \ --port [port id] \ --chunk_size ["5,10,5"=600ms, "8,8,4"=480ms] \ @@ -93,43 +60,45 @@ --audio_in [if set, loadding from wav.scp, else recording from mircrophone] \ --output_dir [if set, write the results to output_dir] \ --send_without_sleep [only set for offline] \ ---ssl [1 for wss connect, 0 for ws, default is 1] +--ssl [1 for wss connect, 0 for ws, default is 1] \ +--mode [`online` for streaming asr, `offline` for non-streaming, `2pass` for unifying streaming and non-streaming asr] \ ``` + #### 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 +python ws_client.py --host "0.0.0.0" --port 10095 --mode offline --chunk_interval 10 --words_max_print 100 ``` 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" +python ws_client.py --host "0.0.0.0" --port 10095 --mode offline --chunk_interval 10 --words_max_print 100 --audio_in "./data/wav.scp" --send_without_sleep --output_dir "./results" ``` ##### 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 +python ws_client.py --host "0.0.0.0" --port 10095 --mode online --chunk_size "5,10,5" --words_max_print 100 ``` 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" --output_dir "./results" +python ws_client.py --host "0.0.0.0" --port 10095 --mode online --chunk_size "5,10,5" --audio_in "./data/wav.scp" --output_dir "./results" ``` ##### 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" +python ws_client.py --host "0.0.0.0" --port 10095 --mode 2pass --chunk_size "8,8,4" ``` 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" --output_dir "./results" +python ws_client.py --host "0.0.0.0" --port 10095 --mode 2pass --chunk_size "8,8,4" --audio_in "./data/wav.scp" --output_dir "./results" ``` ## Acknowledge 1. This project is maintained by [FunASR community](https://github.com/alibaba-damo-academy/FunASR). -- Gitblit v1.9.1