suzu

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 45 Open GitHub ↗

Audio Streaming Gateway Suzu

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Audio Streaming Gateway Suzu

[![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/shiguredo/suzu.svg)](https://github.com/shiguredo/suzu)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

## About Shiguredo's open source software

We will not respond to PRs or issues that have not been discussed on Discord. Also, Discord is only available in Japanese.

Please read https://github.com/shiguredo/oss/blob/master/README.en.md before use.

## 時雨堂のオープンソースソフトウェアについて

利用前に https://github.com/shiguredo/oss をお読みください。

## Audio Streaming Gateway Suzu について

Suzu は [WebRTC SFU Sora](https://sora.shiguredo.jp) 専用の音声解析用ゲートウェイです。
Suzu は Sora から送られてくる音声ストリーミングを HTTP/2 経由で受け取り、音声解析サービスに転送し、その解析結果を Sora に送ります。
Sora は Suzu から送られてきた解析結果を、プッシュ API を経由してリアルタイムにクライアントへ通知します。

## 目的

リアルタイム通話で気軽に音声解析サービスを利用できる仕組みを提供することです。

## 特徴

- Sora から音声データを HTTP/2 経由で受け取り、音声解析サービスへ送信します
- 音声解析サービスの解析結果を HTTP/2 レスポンスで Sora に戻します
- Sora は受け取った解析結果をクライアントへプッシュで送信します
  - [DataChannel 経由のシグナリング](https://sora-doc.shiguredo.jp/DATA_CHANNEL_SIGNALING) の利用を推奨します
- 音声解析に必要とされる言語コードをクライアントごとに指定できます
- 無限リトライ対応
- mTLS 対応

## 使ってみる

Suzu を使ってみたい人は [USE.md](doc/USE.md) をお読みください。

## Suzu と GCP Speech to Text

```mermaid
sequenceDiagram
 participant client1 as クライアント1 sendrecv
 participant client2 as クライアント2 recvonly
 participant sora as WebRTC SFU Sora
 participant suzu as Audio Streaming Gateway Suzu
 participant app as アプリケーションサーバー
 participant gcp as GCP Speech to Text
 note over client1, sora: WebRTC 確立
 sora-)client1: "type": "switched"
 note over client1, sora: DataChannel 確立
 par
 client1-)sora: Opus over SRTP
 sora-)suzu: Opus over HTTP/2
 note over suzu: Opus を Ogg コンテナに詰める
 suzu-)gcp: Ogg over HTTP/2
 note over gcp: 音声データが十分ではないためまだ解析結果が返せない
 and
 client1-)sora: Opus over SRTP
 sora-)suzu: Opus over HTTP/2
 suzu-)gcp: Ogg over HTTP/2
 gcp-)suzu: 音声解析結果 JSON over HTTP/2
 suzu-)sora: 音声解析結果 JSON over HTTP/2
 sora-)client1: プッシュ通知 音声解析結果 JSON over DataChannel
 end
 par
 note over client2, sora: WebRTC 確立
 sora-)client2: "type": "switched"
 note over client2, sora: DataChannel 確立
 and
 client1-)sora: Opus over SRTP
 sora-)suzu: Opus over HTTP/2
 suzu-)gcp: Ogg over HTTP/2
 gcp-)suzu: 音声解析結果 JSON over HTTP/2
 suzu-)sora: 音声解析結果 JSON over HTTP/2
 end
 par
 sora-)client1: プッシュ通知 音声解析結果 JSON over DataChannel
 and
 sora-)client2: プッシュ通知 音声解析結果 JSON over DataChannel
 end
```

## 対応サービス

- [x] [Amazon Transcribe](https://aws.amazon.com/jp/transcribe/)
- [x] [Google Cloud Speech-to-Text](https://cloud.google.com/speech-to-text)
- [ ] [Google Cloud Media Translation](https://cloud.google.com/media-translation)
- [ ] [Microsoft Azure Speech to Text](https://azure.microsoft.com/ja-jp/products/cognitive-services/speech-to-text/)
- [ ] [Microsoft Azure Speech Translation](https://azure.microsoft.com/ja-jp/products/cognitive-services/speech-translation/)
- [ ] [Deepgram](https://deepgram.com/)
- [ ] [AmiVoice Cloud Platform](https://acp.amivoice.com/amivoice/)

## ライセンス

```
Copyright 2022-2024, Hiroshi Yoshida (Original Author)
Copyright 2022-2024, Shiguredo Inc.

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.
```

## 優先実装

優先実装とは Sora のライセンスを契約頂いているお客様限定で Suzu の実装予定機能を有償にて前倒しで実装することです。

### 優先実装が可能な機能一覧

詳細は Discord やメールなどでお気軽にお問い合わせください。

- [Google Cloud Speech\-to\-Text V2 API](https://cloud.google.com/blog/products/ai-machine-learning/google-cloud-speech-to-text-v2-api?hl=en)
- [Google Cloud Media Translation](https://cloud.google.com/media-translation)
- [Microsoft Azure Speech to Text](https://azure.microsoft.com/ja-jp/products/cognitive-services/speech-to-text/) 対応
- [Microsoft Azure Speech Translation](https://azure.microsoft.com/ja-jp/products/cognitive-services/speech-translation/) 対応
- [Deepgram](https://deepgram.com/) 対応
- [AmiVoice Cloud Platform](https://acp.amivoice.com/amivoice/) 対応
- ウェブフック機能対応
  - クライアントごとに接続先サービスを変更できるようになる

suzu

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README