Needle Cloud

概要

Needle Cloudはオンラインサービスです。Web上で3Dアセットやアプリを保存、管理、共有するのに役立ちます。 glTF、USD、FBX、VRMなど、さまざまなファイル形式がサポートされています。Needleで作成された空間Webアプリは、Unity統合から、またはコマンドライン（CLI）を介してクラウドに直接デプロイできます。Blender統合は後日提供予定です。それまではCLIをご利用いただけます。

始めるにはNeedle Cloudにアクセスしてください。

Needle Cloud 概要

機能

  1. 空間Webアプリのホスティング Needleで作成されたアプリは、エンジンの統合機能からクラウドに直接デプロイできます。これにより、独自のサーバーを設定することなく、チームや顧客に簡単にアプリへの公開アクセスを提供できます。必要に応じて、パスワードでアプリを保護することもできます。

  2. プライベートかつ安全な3Dアセット管理 3Dファイルを簡単にアップロードして整理できます。高速なCDN（コンテンツ配信ネットワーク）のおかげで、ファイルは安全に保管され、世界中のどこからでも迅速にアクセスできます。 Needle Cloudはマーケットプレイスでもソーシャルネットワークでもありません。代理店、スタジオ、クリエイターがアセットをプライベートかつ安全に管理できるように設計されています。

  3. 多様な形式の3Dアセットの最適化 ファイルを自動的に圧縮して、視覚的な品質を維持しながらサイズを削減します。これにより、ファイルの読み込みが速くなり、ユーザーデバイスの帯域幅とメモリを節約できます。

  4. 共有とバージョン管理 ファイルへのリンクは他のユーザーと共有したり、プロジェクトで直接使用したりできます。アセットやアプリの新しいバージョンをアップロードできます。個々のバージョンにはラベルを付けることができ、柔軟なレビューワークフローが可能になります。たとえば、バージョンをmainまたはexperimentalとしてラベル付けできます。必要に応じて、ラベルを以前のバージョンに戻すこともできます。

  5. CLIによる自動化およびパイプラインツールneedle-cloud CLI（コマンドラインインターフェース）を使用すると、ファイルのアップロードと最適化を簡単に自動化できます。これは、既存のパイプラインにNeedle Cloudを統合する場合や、多数のファイルのアップロードを自動化する場合に役立ちます。

  6. ライセンス管理 ソロクリエイターおよびチーム向けのNeedle Engineのライセンスは、Needle Cloudを通じて管理されます。これにより、許可されたユーザーのみがファイルとプロジェクトにアクセスできるようになります。エンタープライズおよびEduライセンスについてはお問い合わせください。

Unityからのデプロイ

Needle CloudはUnity Editorに統合されています。これにより、Unityから直接Needle Cloudにアプリをデプロイできます。また、Needle CloudからUnityにアセットを直接アップロードおよびダウンロードすることもできます。

  1. Unity統合をインストールしてください（まだの場合）。 詳細はこのページを参照してください。

  2. シーンにExport Infoコンポーネントを追加します。 このコンポーネントは、アプリのエクスポート設定を構成するために使用されます。 メニュー項目 GameObject > Needle Engine > Add Export Info を使用するか、メニュー項目 File > New Scene からNeedleテンプレートを使用して新しいシーンを作成できます。

  3. Upload to Needle Cloudをクリックします。 これにより、アプリがビルドされ、Needle Cloudにアップロードされます。特定のチームとプロジェクトにデプロイすることも選択できます。ボタンの横に表示されるプロジェクトの_アップロード名_は、シーンに保存されます。今後のアップロードでは同じアップロード名が使用され、アップロードされたすべてのバージョンはNeedle Cloudウェブサイト上でグループ化されます。

    Needle Cloud Unity統合

CLIからのデプロイ

Needle Cloudは、アセットの管理とアプリケーションの効率的なデプロイを可能にするコマンドラインインターフェース（CLI）を提供します。CLIを使用すると、タスクを自動化し、Needle Cloudを既存のワークフローに統合できます。

CLIはnpm packageとして提供されており、Node.jsがお使いのマシンにインストールされている必要があります。端末で以下のコマンドを実行することで、Node.jsがインストールされているか確認できます。

node -v

Node.jsがインストールされていない場合は、Node.jsウェブサイトからダウンロードできます。

needle-cloud CLIパッケージをグローバルにインストールするか、npxを介して使用できます。これにより、グローバルにインストールすることなくCLIコマンドを実行できます。

  1. npxコマンドを使用する（推奨）

    npx needle-cloud deploy '/dist' --team 'My team' --name 'some-project-id'

  2. またはneedle-cloudをグローバルにインストールする グローバルにインストールすると、システムのどこからでもCLIを使用できます。CLIをグローバルにインストールするには、端末で以下のコマンドを実行します。

    npm install -g needle-cloud

    これで、端末でneedle-cloudコマンドを使用できます。

    needle-cloud deploy '/dist' --team 'My team' --name 'some-project-id'

自動デプロイ

Github ActionsまたはStackblitzからデプロイするには、--token <access_token>としてアクセストークンを提供できます。アクセストークンは、Needle Cloud上のチームページで作成できます。read/write権限を持つトークンを作成してください。

Needle Cloud Github Actionを使用して、Githubからアップデートをデプロイできます（例: リポジトリにプッシュするたびに）。

例: Needle Cloud Github Action

      - name: Deploy to Needle Cloud
        uses: needle-tools/deploy-to-needle-cloud-action@v1.0.2
        id: deploy
        with:
            token: ${{ secrets.NEEDLE_CLOUD_TOKEN }}
            dir: ./dist
            name: vite-template # optional

例: CLIコマンドを使用したデプロイ

# Deploy to Needle Cloud from e.g. a github action
npx needle-cloud deploy '/path/to/output' --team 'My team' --name 'some name or id' --token '<access_token>'

CLIヘルプ

helpを使用して、利用可能なすべてのコマンドラインオプションと個々のコマンドのヘルプを表示します。

# see all available options
npx needle-cloud help
# get help for a specific command e.g. deploy
npx needle-cloud help deploy

デプロイURL

Needle Cloudにデプロイすると、各アップロードには一意のURLが付与されます。チームまたはクライアントと、_特定の_バージョンへのリンク、または_ラベル付けされた_バージョンへのリンクを共有できます。

以下の例では、これまでに2回デプロイされたアプリがあります。各デプロイには特定のURLが付与されます。これは特定のバージョンに固定されているため、_固定された_URLとも呼ばれます。

  1. collaborativesandbox-zubcks1qdkhy-1qdkhy.needle.run これはアップロードされた最初のバージョンです。
  2. collaborativesandbox-zubcks1qdkhy-2e2spt.needle.run これはアップロードされた2番目のバージョンです。

_最新_のデプロイは常に以下のURLで利用できます。このURLは常にアプリの最新バージョンを指しているため、チームと共有するのに役立ちます。このバージョンの別の一般的な名前は_dev_または_canary_です。

_main_デプロイはクライアントと共有するのに役立ちます。これは常にプロモートしたアプリの最新バージョンを指しているためです。このバージョンの他の一般的な名前は、production、stable、または_live_です。

  • collaborativesandbox-zubcks1qdkhy.needle.run このURLは新しいバージョンをアップロードしても変更されません。新しいバージョンを_main_に明示的にプロモートした場合にのみ変更されます。

通常、新しいバージョンをアップロードし、レビューしてから、_main_にプロモートするかどうかを決定します。

Needle Cloudウェブサイトには、最新バージョンとmainバージョンを含む、アプリのすべてのデプロイ済みバージョンが表示されます。⋮をクリックし、Set main labelまたはRemove main labelを選択することでラベルを移動できます。

Needle Cloud バージョンリスト

サポートされている3D形式

  1. glTFとGLB 例 glTF形式は、Web上の3Dで最も広くサポートされている形式です。3Dモデル、アニメーション、テクスチャを格納できる軽量な形式です。GLBファイルはglTFファイルのバイナリバージョンで、すべてのデータが単一のファイルに格納されます。 glTFは、Draco、KTX2、Meshoptなどの高度な圧縮技術をサポートしており、これらはNeedle CloudとNeedle Engineによって完全にサポートされています。

  2. OpenUSD USDは、3Dデータ交換のための強力な形式です。映画およびVFX業界での使用で知られており、ゲーム業界でも人気が高まっています。Needle Cloudは、USD-WASMに関する当社の取り組みを通じてUSDZファイルとUSDファイルをネイティブにサポートし、さらに処理と最適化のためにUSDファイルをglTFに変換します。

  3. FBX FBXは長年3Dデータ交換で人気のある形式ですが、PBRマテリアルや拡張機能などの現代的な機能がいくつか不足しています。Needle Cloudは、さらなる処理と最適化のためにFBXファイルをglTFに変換します。

  4. VRM VRMはヒューマノイドアバターの形式です。glTFに基づいており、glTF拡張機能の使用による追加の制約があります。Needle CloudはVRMファイルをネイティブにサポートし、フォニーム、トゥーンシェーディング、ダイナミックボーンなどの複雑なVRM拡張機能を含む、他のglTFファイルのように最適化できます。

  5. OBJ OBJは、3Dモデル用のシンプルなテキストベースの形式です。MTLファイルを介した基本的なマテリアル、アニメーション、オブジェクトの階層をサポートしています。Needle Cloudは、さらなる処理と最適化のためにOBJファイルをglTFに変換します。

可能な場合はglTFまたはUSDを使用する

glTFとUSDは、3Dデータ交換の主要な形式として推奨されます。これらは広くサポートされており、現代的な機能と優れたマテリアルモデルを備えています。

Cloudアセット

アセットのアップロード

ファイルをウェブサイトにドラッグするか、コンピューターから選択することで簡単にアップロードできます。 glTF以外のファイルは、さらなる処理のために自動的にglTFに変換されますが、元のファイルはダウンロードおよびウェブ閲覧用に保持されます。

アセットのバージョン

アセットの編集ページにアクセスすると、これまでにあなたまたはあなたのチームによってアップロードされたすべてのバージョンを確認できます。バージョンを「main」または「experimental」としてタグ付けすることもできます。「Latest」は最新バージョンのデフォルトタグです。

アセットへのリンク共有

特定のファイルまたはタグ付けされたファイルをチームまたはクライアントと共有するためのリンクを作成できます。タグ付きリンクは、タグを移動すると自動的に更新されるため、「main」リンクを一度共有しておけば、新しいリンクを送信することなくファイルを更新し続けることができます。

Needle EngineでのCloudアセットの使用

Needle Cloudに保存されているファイルは、Needle Engineプロジェクトに簡単に直接取り込むことができます。Needle Cloud Assetコンポーネントは、アセットへのリンクを受け取り、ランタイムで読み込みます。これにより、プロジェクトのサイズを小さく保ち、クラウドで更新できるアセットをオンデマンドで読み込むことができます。

可能な場合はProgressive Loadingを使用する

Needle Cloudに保存されているアセットは、Progressive Loadingテクノロジーを使用して、理想的なランタイム使用のために自動的に最適化されます。各メッシュおよびテクスチャに対して、複数のレベル・オブ・ディテールバージョンが生成され、アセットの必要な部分のみがランタイムで読み込まれます。

これにより、帯域幅とメモリを大幅に節約できます（アセット全体を読み込む場合と比較して通常90%以上）。

ウェブサイトへのCloud Viewerの埋め込み

独自のウェブサイトに3Dを組み込む簡単な方法は、Needle Cloud viewerを埋め込むことです。 これを行うには、アセットの編集ページに移動し、Embedをクリックします。次に、iframeコードスニペットをコピーして、ウェブサイトに貼り付けることができます。

特定のバージョンの埋め込み

アセットへの直接リンク、または特定のタグを使用してビューアを埋め込むこともできます。これにより、ウェブサイト上の埋め込みコードを更新することなく、Needle Cloudでアセットを更新できます。

他のフレームワークへの埋め込み

以下の埋め込みオプションが利用可能です。

  1. Needle Cloud Vieweriframeコードスニペットを使用して、Needle Cloudビューアをウェブサイトに埋め込みます。

  2. Needle Engine 提供されているコードスニペットを使用して、web componentとしてNeedle Engineをウェブサイトに埋め込みます。

  3. model-viewermodel-viewerプロジェクトは、ブラウザでシンプルでインタラクティブでない3DモデルをレンダリングするためのWebコンポーネントを提供します。

  4. three.js three.jsに慣れている場合は、提供されているコードスニペットを、Needle Progressive Loadingをサポートし、Needle Cloudからファイルを効率的に読み込むthree.jsアプリの開始点として使用できます。

  5. React-Three-Fiber React-Three-Fiberを使用している場合は、提供されているコードスニペットを、Needle Progressive Loadingをサポートし、Needle Cloudからファイルを効率的に読み込むプロジェクトの開始点として使用できます。

  6. Unity Unityを使用している場合は、Needle Cloud Assetコンポーネントを使用してNeedle Cloudアセットをプロジェクトに直接統合することで、シームレスな読み込みと最適化が可能です。これはUnityビルドでのランタイムでもサポートされています。

UnityまたはUnrealのような他のエンジンでのCloudアセットの使用

Needle Cloudに保存されているアセットを、UnityやUnrealなどの他のエンジンで使用する方法はいくつかあります。

  1. ダウンロードとインポート アセットをダウンロードしてプロジェクトにインポートできます。

  2. 直接リンク プロジェクトでアセットへの直接リンクを使用できます。この方法では、Needle Cloudでアセットを更新すると、プロジェクトでも自動的に更新されます。使用するリンクは、エンジンとそのglTF機能によって異なります。

    • Progressive Loadingを含むglTFのサポート: Progressive-WorldまたはProgressive-Productリンクを使用します。 プログレッシブローディングとそのエンジンの有効化方法の詳細については、npm:@needle-tools/gltf-progressiveを参照してください。

    • DracoとKTX2を含むglTFのサポート: Optimizedリンクを使用します。

    • glTFはサポートしているが、圧縮拡張機能なし: Upload（gltf/glbアップロード用）またはConverted（その他のアップロード用）リンクを使用します。

  3. Needle Cloud Assetコンポーネント Needle Engineを使用している場合は、Needle Cloud Assetコンポーネントを使用してランタイムでアセットを読み込むことができます。プラットフォームに最適なリンクを自動的に選択し、Progressive Loadingを使用してアセットを読み込みます。これはUnityビルドでのランタイムでもサポートされています。

アセット用CLI

Needle Cloudのコマンドラインインターフェース（CLI）を使用すると、ファイルのアップロードと圧縮を自動化できます。CLIはビルドステップの一部（アセットを最適化されたバージョンに置き換える）として、またはスタンドアロンツール（ファイルのバッチ処理用）として使用できます。

CLIとその使用方法の詳細については、npm:needle-cloudを参照してください。

FAQ

  1. Needle Cloudとは何ですか？ 3Dアセットとシーンをアップロード、圧縮、共有するためのオンラインサービスです。

  2. Needle Cloudにアセットをアップロードするにはどうすればよいですか？ ファイルをウェブサイトにドラッグするか、サポートされている統合機能から直接アップロードできます。ファイルが多い場合は、CLI（コマンドラインインターフェース）またはAPI（アプリケーションプログラミングインターフェース）を使用できます。

  3. Needle Cloudから最適化されたファイルをダウンロードするにはどうすればよいですか？ ウェブサイトからファイルをダウンロードできます。Shareをクリックし、次にDownloadをクリックします。CLIを使用してファイルをダウンロードすることもできます。

  4. ファイルを他のユーザーと共有できますか？ はい、ファイルを共有するためのリンクを作成できます。リンクは、直接ダウンロードリンク、またはNeedle Cloudビューアへのリンクのいずれかです。

  5. ファイルサイズに制限はありますか？ アップロード制限はプランによって異なります。詳細についてはアカウントの詳細をご確認ください。

  6. Needle Cloudのファイルは他のツールで使用できますか？ はい、ファイルをglTFとしてエクスポートすることで他のプログラムで使用できます。USDエクスポートは後日提供予定です。

  7. ストレージ容量が不足した場合はどうなりますか？ プランをアップグレードするか、古いファイルを削除して容量を確保する必要がある場合があります。

このページはAIによって自動的に翻訳されました。