コンテンツにスキップ
Cavalry 中文文档

Google Sheets アセット

概要

「概要」という見出しのセクション

Google Sheet Asset は Spreadsheet Utility の入力として使用できます。Google Sheet からデータをインポートすると、誰でもブラウザでデータを編集でき、Cavalry で即時に更新されます。

Google Sheet URL

「Google Sheet URL」という見出しのセクション

Google Sheet の URL をコピーするには：

  • ブラウザタブのアドレスバー/オムニボックスから直接クリップボードにコピーします。
  • Share オプションの Copy Link ボタンを使用してクリップボードにコピーします。注意：Spreadsheet 内に複数のシート/タブがある場合、この方法ではプライマリシートの URL のみがコピーされます。デフォルトでは、このシートの URL は gid=0 で終わりますが、そのシートが削除されている場合は、最後に作成されたシートが使用されます。不明な場合は、ブラウザタブのアドレスバー/オムニボックスから URL をコピーしてください。

シートの参照

「シートの参照」という見出しのセクション

特定のシート/タブを参照するには、そのシート/タブを開いた/アクティブな状態でブラウザのアドレスバー/オムニボックスから url をコピーします。

Share ボタンから利用可能な Link Sharing オプションは Anyone with the link に設定する必要があります。Role は利用可能な任意のオプションに設定できます。

現在、制限付き権限のシートにはアクセスできません。

インポート

「インポート」という見出しのセクション

シートをインポートするには：

  1. 以下のいずれか：
    • Assets Window で右クリックし、Import Google Sheet… を選択します。
    • File > Import Google Sheet... メニュー項目を使用します。
  2. ダイアログウィンドウにシートの url を入力します。
  3. OK をクリックします。

Google Sheet Asset が Assets Window に表示されます。

データの接続

「データの接続」という見出しのセクション

この Asset を Assets Window から Viewport または Scene Window にドラッグすると、Spreadsheet Utility が作成され、Asset がその File 属性に接続されます。

または、Spreadsheet Utility を手動で作成し、Google Sheet Asset を Assets Window からその File 属性にドラッグします。

オプション

「オプション」という見出しのセクション

Google Sheet Asset を右クリックすると以下のオプションが表示されます：

  • Spreadsheet Settings - Cavalry がデータを解釈する方法を定義します（CSV Asset と同じ設定）：
    • Delimiter - データ内の各セルを区切る記号を設定します。注意 - Google Sheets Asset の場合は ,（カンマ）に設定する必要があります。.csv データには異なる区切り文字が含まれる場合があります。
    • Quote - データ内の文字列を決定する記号を設定します。
    • Decimal Separator - 数値の整数部と小数部を区切る記号を設定します（例：12.75 の .）。
    • Factorize - Spreadsheet の Factorize 属性を使用する場合にチェックする必要があります。注意 - データの因数分解はパフォーマンスに影響する可能性があります。
  • Rename - Google Sheet Asset の名前を変更します。
  • Reload - Google Sheet データを再読み込みします。Google Sheet が変更されるたびに必要です。
  • Replace Google Sheet - 現在の Google Sheet のリンクを別のものに置き換えます。
  • Open Google Sheet in Browser - リンクされた Google Sheet を Web ブラウザで開きます。
  • Delete - シーンから Google Sheet Asset を削除します。

列に異なるデータ型（文字列/数値/色など）のセルが混在している場合、セルの内容が「正しく」解釈されるようにシート内でフォーマットを指定する必要がある場合があります。たとえば、以下の最初のセルは数値なので列は数値として読み取られますが、2番目のセルは有効な数値ではないため Cavalry に読み取られません。

Column
28
11/345

この例では、Google Sheets の Format > Number > Plain Text メニュー項目を使用して、これらのセルを「プレーンテキスト」に設定する必要があります。これにより、Spreadsheet Utility で読み取られる際に文字列として解釈されます。これにより、最初のセルの数値 28 は数値/値として読み取られなくなります。