開発者向けドキュメント

インストールと IT

Windows と Linux への Bernard Review のインストール、開放するポート、オフラインでの利用、設定・ログ・クラッシュレポートの場所。

このページは、スタジオのワークステーションを管理する方向けです。プレーヤーは、サイトのダウンロードページから、アカウント不要で無料でダウンロードでき、各ファイルの SHA-256 フィンガープリントも掲載されています。

Windows

  • システム:Windows 10 または 11(64 ビット)。OpenGL 3.0 以降に対応したグラフィックスカード(4K と EXR には NVIDIA を推奨)。

  • インストーラー:BernardReview-<version>-win64.exe。管理者が実行します。C:\Program Files\Bernard Review にインストールされ、プログラムは bin\BernardReview.exe で、スタートメニューに Bernard Review のエントリが作成されます。

  • サイレントインストール(展開ツール、スクリプト向け):/S でウィンドウなしにインストールします。/D= でフォルダーを指定します。必ず最後に置き、スペースを含む場合でも引用符は付けません。

    start /wait BernardReview-<version>-win64.exe /S /D=C:\Program Files\Bernard Review
    echo %ERRORLEVEL%

    終了コードで結果がわかります。

    コード意味対処
    0インストール完了なし
    3インストールフォルダーからプレーヤー(またはストリーミング補助プログラムを含む、そのフォルダー内のプログラム)が起動している。インストーラーは即座に停止し、何も書き込まなかったプレーヤーを閉じてから、もう一度インストールを実行する

    別のフォルダーから起動しているプレーヤーは、インストールを妨げません。インストーラーがプレーヤーを自分で閉じることはありません。保存していないレビューが失われるためです。PowerShell では、(Start-Process .\BernardReview-<version>-win64.exe -ArgumentList '/S' -Wait -PassThru).ExitCode で終了コードを取得できます。

    サイレントインストールは、古い BernardPlayer を確認なしでアンインストールします。 初期の BernardPlayer のバージョン(C:\Program Files\BernardPlayer <version> というフォルダー)が見つかると、対話式のインストールは先にアンインストールするかどうかを尋ねます。/S では「はい」と答えたことになり、それらのアンインストーラーがサイレントで実行されます。このようなワークステーションに展開する場合は、その点を承知のうえで行うか、事前に削除してください。/NOASSOC は、コンポーネントのページでどのように選択されていても、ファイルの関連付けを一切書き込まずにインストールします(どのファイルをプレーヤーで開くかをパイプライン側で決める場合に使います)。

  • ファイアウォール:インストーラーは、プログラム用の受信規則 Bernard Review (LAN sessions) を、Domain と Private のプロファイルにのみ追加します。Public には追加しません(ストリーミング補助プログラムを同梱している場合は Bernard Review (stream companion) も追加します)。アンインストールすると削除されます。

  • SmartScreen:インストーラーにはまだコード署名がないため、Windows が「発行元不明」と表示することがあります。まずフィンガープリントを確認してください。

    Get-FileHash -Algorithm SHA256 .\BernardReview-<version>-win64.exe

    そのうえで 詳細情報 と 実行 を選びます。

  • アプリケーション制御(AppLocker、WDAC):プログラムには署名がありません。パスまたはハッシュによる規則が適用でき、ハッシュ規則はバージョンごとに更新する必要があります。

Linux

RHEL 8、9、10 互換のシステム(Rocky Linux、AlmaLinux、Red Hat Enterprise Linux)の x86-64 プロセッサー向けです。

  • RPM パッケージ:ワークステーションのすべてのユーザー向け(管理者権限が必要)。

    sudo dnf install ./bernard-review-<version>-Linux.rpm

    コマンドは bernard-review です。

  • 自己展開アーカイブ:ホームフォルダー内に、管理者権限なしでインストールします。

    mkdir -p ~/bernard-review
    sh ./bernard-review-<version>-Linux.sh --prefix=$HOME/bernard-review --exclude-subdir
    ~/bernard-review/bin/bernard-review
  • Ubuntu 用の DEB パッケージ:Ubuntu でのテスト完了後に、近日対応予定です。

  • ダイアログ:ファイル選択ダイアログはデスクトップ側のもの(zenity、kdialog、qarma)が使われます。パッケージは zenity を推奨しています。どれもインストールされていない場合、プレーヤーは起動時と、ダイアログが必要になったときに、その旨を表示します:sudo dnf install zenity。

  • カメラ RAW(RED、ARRI、Blackmagic RAW):現時点では Windows のみです。Linux と macOS は近日対応予定です。

macOS:近日対応予定です。

ネットワーク

再生、注釈、書き出し、スタジオのネットワーク上のセッションは、完全にオフラインで動作します。インターネット接続は不要です。

ポート方向使われるとき開放が必要か
TCP 9000受信。スタジオのネットワークまたは VPN からこのワークステーションがレビューセッションをホストしている間ホストのみ
TCP 5556ループバック(127.0.0.1)常時:オートメーション用ポート。Python API と IPCを参照不要
TCP 8080ループバックGoogle アカウントのサインイン中(最長 5 分)不要
TCP 443 送信トラッカーのサイトへTracker ウィンドウを使っている間プロキシの構成による

ゲストに受信ポートは不要です。接続はすべて送信方向です。「このコンピューターのみ」のセッションは、ループバックだけで待ち受けます。

Linux でポート 9000 を開放する。 パッケージには定義ファイルが付属していますが、有効化はされていません。

# firewalld (Rocky Linux, AlmaLinux, RHEL)
sudo firewall-cmd --permanent --zone=<zone> --add-service=bernard-review
sudo firewall-cmd --reload
# ufw (Ubuntu)
sudo ufw allow from <subnet> to any port 9000 proto tcp

<zone> は社内ネットワークのゾーンに、<subnet> はスタジオのサブネットに置き換えてください。Windows のファイアウォールをグループポリシー(GPO)が管理していてローカルの規則が無視される場合は、ポリシー側に規則を追加します。TCP 9000 の受信、対象はこのプログラム、Domain と Private のプロファイルです。

オンラインセッション。 サービスのリレーを経由し、送信接続のみを使います。

宛先ポート役割開放が必要か
review.bernardengine.comTCP 443HTTPS と WSS:同期、ゲスト用の Web ページ、ビデオのシグナリング必要
turn.review.bernardengine.comTCP 443ほかの経路が通らないときのビデオと音声443 しか開いていない場合は必要
review.bernardengine.comUDP 50000-50100ライブのビデオと音声推奨
review.bernardengine.comTCP 7881UDP が閉じているときの、ビデオと音声のフォールバックUDP が閉じている場合は推奨
turn.review.bernardengine.comUDP 3478UDP 上の TURN任意

この 2 つの名前への送信 TCP 443 だけでも、すべてが動作します。遅延はわずかに増えます。プロキシは、これらの名前へのポート 443 の CONNECT を許可し、TLS 検査の対象から外し、アイドル状態の接続を 120 秒未満で切断しないようにしてください。ワークステーションから確認するには、次のようにします。

curl -sS https://review.bernardengine.com/api/v1/health

期待される応答には "status":"ok" が含まれます。

トラッカー。 Kitsu、ftrack、Flow へは、各サイトのアドレスに HTTPS で、サイトのプロキシまたは環境のプロキシ(HTTPS_PROXY、NO_PROXY)を通じて接続します。証明書は常に、システムのストア、またはサイトの認証局ファイルに対して検証されます。

設定とログの場所

システムプロファイルフォルダー
Windows%APPDATA%\BernardReview\
Linux~/.config/bernard-review/(または $XDG_CONFIG_HOME/bernard-review/)

ここには、次のようなものが入っています。

  • player_debug.log(ログ):実際のイベント(クリップの読み込み、デコードエラーなど)だけを記録し、8 MB を超えると player_debug.log.1 にローテーションされます。
  • crashes\(クラッシュレポート):Windows では .dmp のミニダンプ、Linux では .txt のテキストレポートで、名前は UTC の crash-<date>-<time>-<version> です。保持されるのは最新の 5 件だけです。ログの最終行に、書き出されたレポートの名前が記録されます。
  • session_config.json(環境設定、最後のセッション)、keymap.json(ショートカット)、naming_rules.json(Version Board の命名ルール)、trackers.json(シークレットを含まないトラッカーのサイト)、そして color_presets、export_presets、export_recipes、tracker-media の各フォルダー。

問題を報告するには、Help > Send Log to the Bernard Team... を使います。マシンから実際に送信される内容(ログ、チェックを入れた場合に限り最新のクラッシュレポート、バージョン、システム情報)がそのまま表示され、任意のメモを添えられ、Send をクリックするまで何も送信されません。送信後は、連絡の際に伝えるレポート ID が表示されます。ネットワークがない場合は、Open Log Folder からファイルを別の方法で送れます。クラッシュのあとの次回起動では、先に確認が表示されます。Help > About... > Copy System Info は、ユーザー名、マシン名、パス、アドレスを含まない、マシンとライブラリの概要をコピーします。

診断。 環境変数 BERNARDPLAYER_VERBOSE=1 を設定すると、詳細なトレースが追加されます(使用後は削除してください)。BERNARDPLAYER_NO_CRASH_HANDLER=1 を設定すると、デバッガーでクラッシュを捕捉できます。--self-crash を付けて起動すると、意図的にクラッシュさせ、レポートが書き込まれることを確認できます。

set BERNARDPLAYER_VERBOSE=1
"C:\Program Files\Bernard Review\bin\BernardReview.exe"

シークレット。 トラッカーのシークレットは、システムの資格情報ストア(Windows の資格情報マネージャー、Linux の Secret Service)に保存されます。アカウントのサインインデータは、Windows では DPAPI で暗号化されます。

画面共有

リモートアクセスツールや画面共有(Splashtop、Teams、OBS)が、Windows でフルスクリーン再生をカクつきながら受信する場合は、共有している間、環境設定で Present through DWM (smooth screen sharing) にチェックを入れてください。既定ではオフです。ローカルの画面で、フレームが数回繰り返されるという代償があります。

BernardPlayer から移行する場合

このプレーヤーは、以前のバージョンでは BernardPlayer という名前でした。インストーラーは古いインストールを置き換え、初回起動時に古い設定フォルダー(%APPDATA%\BernardPlayer、~/.config/bernardplayer)を変更せずにコピーします。移行期間中は、BernardPlayer.exe と bernardplayer でもプレーヤーが起動します。名前でプログラムを終了させるスクリプトは、両方の名前を指定してください。

さらに詳しくは、完全版マニュアルのパート 12 と 13(プレーヤーの Help > User Guide)、およびサイトの IT 部門向けページを参照してください。

アップデート

起動時に、お使いのシステム向けの新しいリリースがあるかどうかを、バックグラウンドで確認します(送信するのはバージョン番号だけです)。新しいリリースがあると、バナーに、Windows では Update(Linux と macOS ではダウンロードページへの Download)、What's New(プレーヤー内に表示されるリリースノート)、Later が表示されます。Update はインストーラーをバックグラウンドでダウンロードし、サイズと SHA-256 をサイトが告知している値と照合します(一致しないものは実行されません)。そのあと、プレーヤーが待機状態(再生、セッション、書き出し、入力のいずれもない状態)になると、Restarting to install in 10 s のカウントダウンが始まります(Restart Now、Not Now)。0 になるとプレーヤーはセッションを保ったまま閉じ、インストーラーがサイレントで実行され(UAC は引き続き管理者の確認を求めます)、プレーヤーはユーザー自身のアカウントで、セッションを元のままにして再び開きます。Update をクリックしない限り何も起こらず、再生、セッション、書き出しの最中に実行されることもありません(待機します)。Not Now を選ぶか、手動で閉じた場合は、閉じるときにインストールされ、プレーヤーは再起動されません。Preferences > General > Updates: Ask / Never で確認をオフにできます。IT 部門は、環境変数 BERNARD_NO_UPDATE_CHECK=1、レジストリキー HKLM\Software\AArts Lab\Bernard Review\NoUpdateCheck=1(Windows)、または {"update_check": false} を含むファイル /etc/bernard-review/policy.json(Linux)で、これを強制できます。