Skip to content

Commit

Permalink
Update: [Readme.md] ドキュメントを更新
Browse files Browse the repository at this point in the history
  • Loading branch information
tsukumijima committed Nov 14, 2023
1 parent f037a87 commit 77eb1f1
Showing 1 changed file with 15 additions and 14 deletions.
29 changes: 15 additions & 14 deletions Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@

- **Windows 10/11 PC または Linux (Ubuntu) PC**
- **Windows 10 Pro と Ubuntu 20.04 LTS の PC でのみ動作確認を行っています。**
- Windows 11 でも動作するとは思いますが、手元に環境がないため、検証はできていません
- Windows 11 でも動作するとは思いますが、手元に環境がないため、検証は行っていません
- 32bit 版の Windows 10 には対応していません。
- **Linux PC は Ubuntu (20.04 LTS 以降) / Debian (11 Bullseye 以降) のみサポートしています。**
- Linux PC では、Docker で動かすこともできます(後述)。
Expand All @@ -95,12 +95,13 @@
- ビルド済みのサードパーティーライブラリは glibc 2.31 以上に依存しています。Docker を使わずにインストールする場合、[glibc 2.30 以下を採用する OS](https://repology.org/project/glibc/versions) では動作しません。
- ARM 向けには、Rockchip RK3568 / RK3588 SoC のハードウェアエンコーダーに対応しています。
- arm64 のみに対応しています。armhf などの 32bit ARM には対応していません。
- ラズパイ4はハードウェアエンコーダーが非力なのと入手性が微妙なため、当面サポート予定はありません
- ラズパイ4はハードウェアエンコーダーが非力なのと入手性が微妙なため、サポート予定はありません
- ARM 向けのインストーラーも用意していますが、テスト不足のため、動作する保証はありません。
- **EDCB または Mirakurun**
- KonomiTV のバックエンドには、EDCB または Mirakurun のいずれかを選択できます。
- **EDCB は、220122 以降のバージョンの [xtne6f 版 EDCB](https://github.com/xtne6f/EDCB) / [tkntrec 版 EDCB](https://github.com/tkntrec/EDCB) にのみ対応しています。**
- **220122 以前のバージョンの EDCB では正常に動作しません。<ins>「人柱版10.66」などの古いバージョンをお使いの場合は、EDCB のアップグレードが必要です。</ins>**
- 230922 以降の xtne6f 版 / tkntrec 版 EDCB に更新すると EpgDataCap_Bon の起動が少し高速化され、KonomiTV でより快適にチャンネルを切り替えられるようになります。**
- **最新の EDCB のビルド済みアーカイブは [tsukumijima/DTV-Builds](https://github.com/tsukumijima/DTV-Builds) にて配布しています。** こだわりがなければ、DTV-Builds で配布しているアーカイブの利用を強くおすすめします (動作確認も DTV-Builds で配布しているアーカイブで行っています)。
- **KonomiTV と連携するには、さらに EDCB に事前の設定が必要になります(後述)。**
- **Mirakurun は 3.9.0 以降を推奨します。**
Expand All @@ -110,23 +111,22 @@
### クライアント

- **PC: Google Chrome**
- Firefox でも動作するはずですが、コメント描画が重く、コメント表示をオンにするとライブストリーミングが時折止まることが確認されています。
- 動作確認も基本行っておらず、積極的なサポートはしていません。Chrome を使うことをおすすめします。
- Mac の Safari はサポートしていません。Mac でも Chrome を使ってください。
- **Windows 版 Microsoft Edge は https://github.com/tsukumijima/KonomiTV/issues/58 の問題 (Edge 側のバグ) があるため非推奨です。**
- 仮にこの問題がなかったとしても、Microsoft Edge では通信節約モード (HEVC) での視聴に有料の [HEVC ビデオ拡張機能](https://apps.microsoft.com/detail/9NMZLZ57R3T7) プラグインが別途必要になります。
- Chrome ではこのような制約はないため、Chrome を使うことをおすすめします。
- Firefox でも動作するはずですが、コメント描画が重く、コメント表示をオンにするとライブストリーミングが時折止まることが確認されています。
- 動作確認も基本行っておらず、積極的なサポートはしていません。Chrome を使うことをおすすめします。
- Mac Safari はサポートしていません。Mac でも Chrome を使ってください。
- **Android: Google Chrome**
- Android の Firefox はサポートしていません。
- **iPhone (iOS) / iPad (iPadOS): Safari**
- iOS / iPadOS 17.0 で動作確認を行っています。
- iOS / iPadOS の Chrome (WKWebView) はサポートしていません。
- 技術的な制約により、iOS / iPadOS Safari ではほかのブラウザと異なるストリーミング方式 (LL-HLS) を利用しています。現状の制約は下記の通りです。
- 放送大学ラジオなどのラジオチャンネルが聴取できません。
- 低遅延モードのオン/オフは効果がなく、常に低遅延でストリーミングされます。
- あまりテストされていないため、潜在的なバグがある可能性があります。
- Safari は全体的にバグが多く開発が大変なため、全体的にあまり動作確認を行っていません。修正できていない不具合があるかもしれません。
- PWA でも動作しますが、Safari 側のバグで PWA では残念ながら Picture-in-Picture ボタンが動作しません。
- **iOS / iPadOS 17.1 以降のみに対応しています。17.0 以前の iOS / iPadOS バージョンのサポートは廃止されました。**
- iOS 17.1 で ManagedMediaSource API がサポートされたため、KonomiTV 0.9.0 以降では iOS / iPadOS でも PC・Android と同じ再生方式 (mpegts.js) で再生します。
- メンテナンスコストの観点から、以前の LL-HLS 再生方式は廃止されました。iPadOS では 17.0 以前でも一応動作しますが、iOS では 17.1 以降でないと視聴開始に失敗します。
- 動作確認は iOS / iPadOS 17.1 で行っています。
- **iOS / iPadOS の Chrome (WKWebView) はサポートしていません。**
- Safari は全体的にバグが多く開発が大変なため、全体的にあまり動作確認を行えていません。修正できていない不具合があるかもしれません。
- PWA でも動作しますが、Safari 側のバグにより、PWA モードでは残念ながら Picture-in-Picture ボタンが動作しません。

## 備考・注意事項

Expand All @@ -142,9 +142,10 @@
- **Fire タブレット (Fire HD 10 (2021) / Fire HD 8 (2022)) でも動作します。**
- Fire HD 10 (2021) では Google Play を導入した上で、Google Play 経由で Chrome をインストールしてください。
- Fire HD 8 (2022) では現状 Google Play が導入できないため、適宜 Chrome の APK を入手してインストールしてください。Chrome は、(Google アカウントとの同期機能以外は) GMS がインストールされていなくても動作します。
- **Fire HD 10 (2021) などの一部のローエンド Android (特に MediaTek SoC 搭載) デバイスでは、1080p 以上の映像描画が不安定なことが確認されています。** その場合は 720p 以下の画質を選択することをおすすめします。
- **今後、開発の過程で設定や構成が互換性なく大幅に変更される可能性があります。**
- **ユーザービリティなどのフィードバック・不具合報告・Pull Requests (PR) などは歓迎します。**
- 技術スタックはサーバー側が Python 3.10 + [FastAPI](https://github.com/tiangolo/fastapi) + [Tortoise ORM](https://github.com/tortoise/tortoise-orm) + [Uvicorn](https://github.com/encode/uvicorn) 、クライアント側が Vue.js 2.x + [Vuetify](https://github.com/vuetifyjs/vuetify) 2.x の SPA です。
- 技術スタックはサーバー側が Python 3.11 + [FastAPI](https://github.com/tiangolo/fastapi) + [Tortoise ORM](https://github.com/tortoise/tortoise-orm) + [Uvicorn](https://github.com/encode/uvicorn) 、クライアント側が Vue.js 2.x + [Vuetify](https://github.com/vuetifyjs/vuetify) 2.x の SPA です。
- Vuetify は補助的に利用しているだけで、大部分は独自で書いた SCSS スタイルを適用しています。
- コメントを多めに書いたりそれなりにきれいにコーディングしているつもりなので、少なくとも TVRemotePlus なんかよりかは読みやすいコードになっている…はず。
- 他人が見るために書いたものではないのであれですが、一応自分用の [開発資料](https://mango-garlic-eff.notion.site/KonomiTV-90f4b25555c14b9ba0cf5498e6feb1c3)[DB設計](https://mango-garlic-eff.notion.site/KonomiTV-544e02334c89420fa24804ec70f46b6d) 的なメモを公開しておきます。もし PR される場合などの参考になれば。
Expand Down

0 comments on commit 77eb1f1

Please sign in to comment.