Whatnot や Fanatics Live の配信を解析する

インストールする

このスクリプトは ~/.cardstream に仮想環境（venv）を作り、リリース版の wheel をチェックサムで検証し、モデルの重みを取得して、コマンドを PATH に追加します。wheel、Docker、ソースからのインストールはダウンロードページにあります。

$ curl -fsSL https://raw.githubusercontent.com/Ximilar-com/cardstream/main/scripts/install.sh | sh

キーを設定する

識別はデフォルトで Ximilar の collectibles/v2 を通して行われます（代わりに自前のシステムを使うこともできます）。読み込まれる環境変数は XIMILAR_API_KEY ただ1つです。配信当日に再起動しても消えないよう、シェルのプロファイルに書いておきましょう。

$ export XIMILAR_API_KEY=your-key

ノートパソコンにカードをかざす

これで内蔵ウェブカメラを使ったブラウザ UI が開きます。カードを一瞬じっと構えてみてください。オーバーレイにステートマシンが判断している様子が表示され、続いて名前、セット、信頼度が出て、マッチ（一致）の横には識別呼び出しにかかった実時間が表示されます。これが製品のすべてです。このページの残りは、映像をどこから持ってくるかの話にすぎません。

$ cardstream-web
# → http://127.0.0.1:8001

何をブレイクするか教える

ゲームやセットをあらかじめ指定すると検索範囲が絞られ、呼び出しは速く、マッチは正確になります。ルールは1つだけ。--game を渡すときは必ず --alphabet も渡してください。ゲームを指定するとエンドポイント側の文字体系の自動判定が無効になり、ラテン文字が前提になるため、日本語のカードが英語版としてマッチしてしまいます。

$ cardstream-web --source 1 \
    --game "Pokémon" --alphabet japanese --set-code M4

配信中に切り替える

次のロットが別のゲームになっても、何も再起動する必要はありません。カテゴリ、ゲーム、セットコード、文字体系、結果のしきい値、シャープネスのしきい値は、配信中でもブラウザの設定ダイアログから変更できます。それ以外（検出器、ゲート、解像度）は起動時に一度だけ読み込まれるので、今のうちに決めておきましょう。

ログは残し、ポートは閉じたまま

--split-results を付けると、繰り返し登場したカードをまとめずに、登場するたびに1行ずつ記録します。見せた順に並んだリストができるので、あとから注文と突き合わせるのに便利です。--host はデフォルトの 127.0.0.1 のままにしてください。このプロセスはあなたのキーを保持しており、ローカル UI には認証がないため、LAN から到達できる状態にしてはいけません。

$ cardstream-web --source 1 --split-results

配信を保存して、翌朝に振り返る

--ximilar-stream NEW を付けると、その記録の各行（カード、価格、配信に映っていた時間、識別に使われた切り抜き）が、配信している間に Ximilar アカウントのセッションへ保存されます。配信後は Ximilar アプリの Cardstream セクションで配信全体を確認できます。総額、最も高額なカード、画像付きのすべてのカードが並び、売れたカードに印を付けたり、誤ったマッチを修正したりするのもここで行います。配信の途中でクライアントが再起動したら、NEW の代わりに表示されたセッション ID を付けて起動し直せば、同じ配信の続きとして記録されます。チームのワークスペースに保存するには --ximilar-workspace を使います。

$ cardstream-web --source 1 --price-stats --ximilar-stream NEW
# 再起動後:
$ cardstream-web --source 1 --price-stats --ximilar-stream <session-id>