Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zhihu/griffith
A React-based web video player
https://github.com/zhihu/griffith
fmp4 hls html5-video html5-video-player mp4 mp4box react react-components video zhihu zhihu-video-player
Last synced: 3 days ago
JSON representation
A React-based web video player
- Host: GitHub
- URL: https://github.com/zhihu/griffith
- Owner: zhihu
- License: mit
- Created: 2019-03-22T06:08:17.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-18T12:49:27.000Z (10 months ago)
- Last Synced: 2025-01-02T04:07:13.748Z (10 days ago)
- Topics: fmp4, hls, html5-video, html5-video-player, mp4, mp4box, react, react-components, video, zhihu, zhihu-video-player
- Language: TypeScript
- Homepage: https://codesandbox.io/embed/p03wm0o80
- Size: 4.01 MB
- Stars: 2,504
- Watchers: 42
- Forks: 225
- Open Issues: 36
-
Metadata Files:
- Readme: README-ja.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING-zh-Hans.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-github-star - griffith - based web video player | zhihu | 2453 | (TypeScript)
README
React に基づいたビデオプレイヤー
[](https://github.com/zhihu/griffith/blob/master/LICENSE)
[](https://www.npmjs.com/package/griffith)
[](https://coveralls.io/github/zhihu/griffith?branch=master)
[](https://github.com/zhihu/griffith/blob/master/CONTRIBUTING.md)
[English](./README.md) | [简体中文](./README-zh-Hans.md) | [日本語](./README-ja.md)
# はじめに
- **ストリーミング:** Griffith はストリーミングを簡単にします。ビデオフォーマットは mp4 や hls にかかわらず、Griffith は Media Source Extension (MSE) を使ってセグメントをロードすることができます。
- **拡張性:** Griffith は React アプリにビデオ機能をサポートすることを簡単にします。React に基づいていない場合は、ブラウザで直接使用するための UMD（Universal Module Definition）もサポートされています。
- **信頼性:** Griffith は Zhihu の Web およびモバイル Web で広く使用されています。
## 使い方
### React アプリ
```bash
yarn add griffith
```
```js
import Player from 'griffith'
const sources = {
hd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_hd.mp4',
},
sd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_sd.mp4',
},
}
render()
```
[詳しく](./packages/griffith/README.md)
**ノート: Griffith は SSR アプリを対応できません**
### React を使用していない場合
```html
```
```js
const sources = {
hd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_hd.mp4',
},
sd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_sd.mp4',
},
}
Griffith.createPlayer(element).render({sources})
```
[スタンドアロンモードの詳しい使い方](./packages/griffith-standalone/README.md)
## プロジェクトの構造
Griffith は [Yarn workspace](https://yarnpkg.com/lang/en/docs/workspaces/) と [Lerna](https://github.com/lerna/lerna) を使っている Monorepo です。
### コーア
- `packages/griffith`: コーアライブラリ
### ユーティリティ
- `packages/griffith-message`: クロスドメイン通信のヘルパー
- `packages/griffith-utils`: 他のユーティリティ
### プラグイン
- `packages/griffith-mp4`: MP4 プラグインは [MediaSource API](https://developer.mozilla.org/en-US/docs/Web/API/MediaSource) を使っています。
- `packages/griffith-hls`: [HLS](https://developer.apple.com/streaming/) プラグインは [hls.js](https://github.com/video-dev/hls.js) を使っています。
### その他
- `example`: サンプル例とデモ
- `packages/griffith-standalone`: 全部のモジュールを含めての UMD バージョン、ブラウザーで直接に使用できます。
## カスタムビルド
webpack のようなビルドツールはデフォルトで `griffith-mp4` と `griffith-hls` を含みます。ビルド時にエイリアスを挿入することでプラグインを削除できるため、パッケージサイズを縮小できます。
webpack を使いる場合, [resolve.alias](https://webpack.js.org/configuration/resolve/#resolvealias) が使えます。
```javascript
// webpack v5+
module.exports = {
resolve: {
alias: {
'griffith-hls': false,
'griffith-mp4': false,
},
},
}
// webpack v4
module.exports = {
resolve: {
alias: {
'griffith-hls': 'griffith/null',
'griffith-mp4': 'griffith/null',
},
},
}
```
ノート：`griffith-mp4` と `griffith-hls` がないと、ブラウザがネイティブにサポートしている限り、Griffith は MP4 と HLS メディアを再生できなくなります。
## 貢献
下記のとおり、Griffith への貢献はどんなものでも歓迎です。
### 貢献ガイド
[貢献ガイド](./CONTRIBUTING.md)を読んて、開発プロセスに参加します。
### 貢献者一覧
- [Cheng Wang](https://github.com/wangcheng678)
- [Wuhao Liu](https://github.com/liuwuhaoo)
- [Xiaoyan Li](https://github.com/lixiaoyan)
- [Tianxiao Wang](https://github.com/xiaoyuhen)
- [Xiaoshuang Bai (Designer)](https://www.behance.net/shawnpai)
## ライセンス
MIT