voluntas/ayame_labo.rst

## ayame_labo.rst

      
    Raw
  

              ayame_labo.rst
            
          
    時雨堂 Ayame Labo 開発ログ


日時: 2022-04-19

作: 時雨堂

バージョン: 2022.1

URL: https://ayame-labo.shiguredo.app/


このサービスに興味がある人はこの資料に Star をつけてもらえると嬉しいです。

Contents

概要
目的
利用する
OpenAyame プロジェクト
方針
ゴール
特徴
支える技術
利用方法
Discord
進捗


概要

Ayame Labo は Ayame 仕様 の WebRTC の P2P 利用向けの無料で利用できるシグナリングサービスです。
シグナリングサーバ以外に、ルーム認証機能や TURN サーバを提供しています。
将来的にはウェブフックを利用した自前での認証/承認機能が利用可能になる予定です。

目的

このサービスは Ayame を気軽に利用してもらいたいという思いから、提供しています。

利用する

GitHub アカウントさえあれば、すぐに無料で利用できます。
Ayame Labo

OpenAyame プロジェクト

Ayame 仕様のリファレンス実装である WebRTC Signaling Server Ayame は OpenAyame プロジェクトとして開発しています、詳細は以下をご確認ください。
OpenAyame プロジェクト

方針

このサービスを長く続けていきたいと考えているため、コスト削減を最初から行います。

このサービスのための機能を Ayame 側に追加することはしません
無料プランのみで、有料プランは提供しません
サポートは提供しません
デザインは最低限です
運用保証は行いません
帯域保証は行いません


ゴール


[x] 無料で利用可能
[x] 認証なしでの利用
[x] GitHub ID ログインした場合はシグナリングキーを利用可能
[x] STUN 払い出しの対応
[x] TURN 払い出しの対応
[x] 認証ログ確認機能


特徴


ルーム認証機能

ルーム ID に <GitHub ID>@ をつけることで、接続にシグナリングキーを要求します。

認証ログ確認機能


支える技術


Ayame 仕様互換の Erlang 版 Ayame
GitHub
GitHub Actions
Ansible
coturn
https://github.com/coturn/coturn


Redis
Go
Gin
go-sqlite3
sqlx
squirrel
zerolog
lumberjack


SQLite3
Vultr
https://www.vultr.com/
月 $ 6 のサーバです
1C / 1G
転送量は 2 TiB しかありません


利用方法

まずはこちらをご覧ください。
Ayame Labo の使い方

Ayame Web SDK を利用する

OpenAyame/ayame-web-sdk: Web SDK for WebRTC Signaling Server Ayame
Ayame で利用できる Web SDK が公開されていますので、それを利用してください。

シグナリングキーなし


ルーム ID はここでは test-ayame-labo-room としていますが、推測されにくい値を指定してください

const conn = Ayame.connection('wss://ayame-labo.shiguredo.app/signaling', 'test-ayame-labo');
const startConn = async () => {
    const mediaStream = await navigator.mediaDevices.getUserMedia({audio: true, video: true});
    await conn.connect(mediaStream);
    conn.on('disconnect', (e) => console.log(e));
    conn.on('addstream', (e) => {
        document.querySelector('#remote-video').srcObject = e.stream;
    });
    document.querySelector('#local-video').srcObject = mediaStream;
};
startConn();
これで接続できます。

シグナリングキーあり


ルーム ID を <自分の GitHub ID>@<好きな Room ID> のように指定してください
自分のシグナリングキーをオプションで指定してください

const conn = Ayame.connection('wss://ayame-labo.shiguredo.app/signaling', 'shiguredo@test-ayame-labo');
const signalingKey = 'CO6p4pdJH4n7SfM6dBLIFzpvop9kefkypoDsddoPMhp3m4FX';
const startConn = async () => {
    const mediaStream = await navigator.mediaDevices.getUserMedia({audio: true, video: true});
    await conn.connect(mediaStream, {'key': signalingKey});
    conn.on('disconnect', (e) => console.log(e));
    conn.on('addstream', (e) => {
        document.querySelector('#remote-video').srcObject = e.stream;
    });
    document.querySelector('#local-video').srcObject = mediaStream;
};
startConn();
これで接続できます。

WebRTC Native Client Momo で利用する

shiguredo/momo: WebRTC Native Client Momo
Momo で Ayame が利用できます。

シグナリングキーなし


ルーム ID はここでは test-ayame-labo-room としていますが、推測されにくい値を指定してください

./momo --no-audio ayame wss://ayame-labo.shiguredo.app/signaling test-ayame-labo


シグナリングキーあり


ルーム ID を <自分の GitHub ID>@<好きな Room ID> のように指定してください
自分のシグナリングキーをオプションで指定してください

GitHub ID が shiguredo で、 ルーム ID が test-ayame-labo の場合:
./momo --no-audio ayame wss://ayame-labo.shiguredo.app/signaling shiguredo@test-ayame-labo \
    --signaling-key CO6p4pdJH4n7SfM6dBLIFzpvop9kefkypoDsddoPMhp3m4FX


Discord

https://discord.gg/shiguredo

進捗


2024-08-29


Ayame Labo TURN-UDP のポートを 3478/UDP に変更しました
Ayame Labo TURN-TCP のポートを 3478/TCP に変更しました
Ayame Labo TURN-TLS のポートを 5349/TCP に変更しました
Ayame Labo STUN サーバーのポートを 3478/UDP に変更しました
Ayame Labo TURN サーバーの転送量制限を廃止しました
Ayame Labo TURN サーバー利用時の帯域利用を 500 kbps に変更しました


2022-04-20


Ayame Labo サービスドメインを ayame-labo.shiguredo.app に変更しました
Ayame Labo TURN サーバを独立させ転送量を 2 TiB に変更しました
Ayame Labo の利用を日本国内のみに制限しました


2021-01-23

サンプルに AV1 を追加しました。

2020-11-01

Ayame Labo をリリースしました。

2019-12-09

正式リリースでは Ayame Lite を Ayame Labo という名前でリリース予定です。

2019-09-18


wss://ayame.shiguredo.jp/ws を無効にしました


2019-09-12


支える技術を追記しました


2019-09-11


認証ログ機能を追加しました
直近 5 件の認証ログが確認できます


2019-09-01


Ayame Lite の利用方法を公開しました
WebRTC シグナリングサービス Ayame Lite の使い方


2019-08-30


Discord を Ayame と同じサーバ内に別チャンネルとして用意しました
https://discord.gg/z6EJu3d


2019-08-14


オープンベータテスト開始しました
https://ayame-lite.shiguredo.jp/beta


オープンベータテスト向けにシグナリングキーありのサンプルを用意


2019-08-10


wss://ayame-lite.shiguredo.jp/signaling に変更しました
wss://ayame.shiguredo.jp/ws は使えなくなりました


2019-08-09


サービス名を Ayame Lite にしました
クローズドベータテストの参加募集を開始しました
GitHub ID が必要です
シグナリングキーが払い出されます
ルーム ID に自分の GitHub ID を prefix として利用することでそのルーム ID に認証をかけられます
TURN サーバ用の設定が払い出されます
Web SDK を使っていれば意識する必要はありません


2019-08-07


TURN の払い出し設定を iceServers に変更


2019-07-27


認証サーバの開発を開始しました
GitHub アカウントを持ってシグナリングキーを取得することで特定のチャネルにアクセスするには認証が必要になります


TURN サーバ連携の開発を開始しました
シグナリングキーを利用した場合は TURN サーバで利用できる TURN 向け設定をシグナリングサーバが払い出すようになります


2019-07-13


WebRTC Signaling Server Ayame as a Service (仮) を公開しました
日時:	2022-04-19
作:	時雨堂
バージョン:	2022.1
URL:	https://ayame-labo.shiguredo.app/