Contents
導入要約とクイックスタート（Arkio 使い方）
導入の第一歩として、目的別に最短で実行できる手順を示します。初心者はインストールと基本操作、導入担当者はパイロット計画とネットワーク、運用者は日常チェックと障害初動を優先してください。以下のクイックスタートは15〜30分の評価セッションを前提にしています。
初心者向けクイックスタート
Arkioを初めて使う方向けの最低限の手順と期待される結果です。
- 端末を決めてインストールする（Meta Quest / PC / iPad）。
- 期待結果：アプリがインストールされ、起動してログイン画面が出る。
-
よくあるエラー例と対処：ストレージ不足→不要アプリ削除、地域未配信→別ストア/公式ダウンロード確認、インストール失敗→端末OS更新。
-
アカウントを作成してログインする。
- 期待結果：アカウントでログインでき、セッションの作成画面に進める。
-
対処例：SSOでログインできない場合は、個別の社用メールでの登録を検討。
-
短い共同セッションを作って操作を確認する（ホストがセッション作成、他端末を招待）。
- 期待結果：参加者の表示が同期され、オブジェクトが共有される。
-
同期されない場合：全員のArkioバージョンを揃え、ネットワーク（Wi‑Fi帯域）を確認。
-
スナップショットやエクスポートで成果を保存する。
- 期待結果：スナップショットが保存され、エクスポートファイルが生成される。
- エクスポート失敗時：モデルを軽量化して再試行。
導入担当者向けクイックスタート
パイロット設計と評価指標の最小セットです。短期間で導入可否を判断するための流れを示します。
- 評価目的と成功基準を定義する（例：クライアントレビュー時の遅延<閾値、BIM同期の整合性）。
- テスト範囲を決める（端末台数、モデルサイズ、参加者数）。
- 事前準備：端末更新、GPU/ドライバ更新、ネットワーク帯域確認（5GHz推奨）。
- テストケースを作る（インポート、共同編集、Revit同期）。15〜30分のセッションで各ケースを実行。
- 測定項目を記録（同期時間、表示遅延、クラッシュ発生の有無、CPU/GPU負荷の有無）。
運用者向けクイックスタート
日常運用の手順と障害の初動対応を簡潔にまとめます。
- セッション前チェック：端末充電、Arkioバージョン、コントローラー電池、ネットワーク状態を確認。
- 役割分担：ホスト（権限管理）、モデリング担当、記録担当を明確化。
- 作業中ルール：重要変更前にスナップショット保存、編集権限は必要最小限に。
- 障害初動：同期トラブル→バージョン確認→再起動→最小モデルで再現→ログ収集（詳細は後述）。
Arkio インストール：対応デバイスと配布経路
Arkioの配布形態と導入時の管理上の注意点をまとめます。企業導入では配布方法（ストア配布／ネイティブ配布／MDM配布）と端末管理の方針を早期に決めてください。以下は主要プラットフォームごとの手順と想定エラー例です。
Meta Quest：入手とインストール手順（Meta Quest Store）
Meta Questでの導入手順と実務上の注意点を示します。
- 手順概要：ヘッドセットのOSを最新化→Meta Quest Storeで「Arkio」を検索してインストール→起動してログイン→コントローラーとトラッキングを確認。
- 期待結果：アプリが起動し、コントローラー操作でメニューが開く。
- よくある問題と対処：ストレージ不足→不要アプリ削除、トラッキング不良→Guardian再設定・ファームウェア更新、地域未配信→公式ダウンロード/企業向け配布を検討。
- 企業配布の注意：管理対象デバイス向けにはMDMやビジネス向け配布経路を利用する。配布方法はArkioの配布ポリシーに従うこと。
PC（Steam／公式ネイティブ版）の導入
PC向け導入の選択肢と実務上のポイントです。
- 手順概要（Steam版）：SteamクライアントでArkioを検索してインストール。VR利用はSteamVR等のランタイムが必要。
- 手順概要（ネイティブ版）：公式サイトのダウンロードページからインストーラーを取得して実行。管理者権限が必要な場合あり。
- 期待結果：デスクトップ起動やVRセッションが開始できる。
- よくある問題と対処：ランタイム未導入→SteamVR等をインストール、ドライバ古い→GPUドライバ更新、インストール権限不足→ITによる管理者承認。
iPad／モバイルの導入（App Store）
タブレット・モバイルでの導入手順と注意点です。
- 手順概要：App Storeで「Arkio」を検索してダウンロード→iOSの互換バージョンを確認→起動してログイン。
- 期待結果：タッチ操作で注記や簡易編集が可能。
- よくある問題と対処：OS非対応→iOS更新、App Storeで見つからない→地域配信やデバイス互換性を確認。
ネットワーク・セキュリティとログ収集（IT導入担当者向け）
企業ネットワークで安定運用するために必要な設計指針と、障害発生時のログ収集手順を実務的に示します。ここで示すポートやドメインは一般的なWebRTCベースの協業アプリの想定例であり、導入前に配布先の公式仕様と照合してください。
ネットワーク要件（想定例）
以下は一般的に必要になりやすい通信設定の例です。最終的なドメイン/ポートは公式情報で確認してください。
- 基本通信：アウトバウンド TCP 443（HTTPS）を許可。
- WebRTC/STUN/TURN：UDP 3478（STUN/TURN）やTCP 5349（TURN over TLS）を想定。
- メディア用エフェメラルポート：UDP 49152–65535（OS割当の範囲）を使用する場合がある。
- DNS／認証：SSOを使う場合はIdPのドメインを許可。
- QoS：低遅延を優先する場合は音声/映像トラフィックの優先度を検討。
ファイアウォール・プロキシ設定の注意点
TLS中間者検査や透過プロキシは接続を妨げることがあります。推奨設定と回避策を示します。
- TLSインスペクション：証明書書換を行うとセッション確立に失敗する可能性があるため、Arkio関連のドメインは例外扱いにすることを推奨。
- プロキシ認証：プロキシ経由での接続が必要な場合は、Arkioクライアントがプロキシ認証に対応するか検証する。
- NAT：多数の同時接続がある環境ではSTUN/TURN経由の通信が必要になる。TURNサーバへのアクセスを確認。
ログ収集と初動対応手順
障害時にITが速やかに対応できるよう、収集すべき情報と手順を整理します。
- 事前情報を記録する：発生時刻（UTC推奨）、Arkioのバージョン、端末種別、セッションID、再現手順を明記。
- 端末ログの取得（プラットフォーム別の代表例）：
- Meta Quest：デベロッパーモードを有効にしADBでログ取得（例: adb logcat -d > arkio_logcat.txt）。
- Windows：アプリのログ出力機能があればそれを使用。無ければイベントビューアのアプリケーションログをエクスポート。Steam/SteamVRログも併せて取得。
- macOS/iOS：Console.appやXcodeのデバイスログを取得。
- ネットワーク情報：PCやルータでのパケットキャプチャ（pcap）を可能な範囲で取得すると原因特定が早まる。
- 初動対処：バージョン確認→最小モデルで再現→端末再起動→ネットワーク切替（別Wi‑Fiや有線）で切り分け。
- サポートへ提出する情報：再現手順、ログ一式、スクショや画面録画（可能であれば）、ネットワーク状況（帯域/遅延）。Arkio側の受付方法は参考リンクを参照。
Arkio Revit 連携を含むファイル入出力とBIMワークフロー
BIM連携で重要なのは事前のルール定義と小規模テストです。ここでは対応フォーマット、プラグイン導入の流れ、データ整合性の運用ルールを示します。
対応フォーマットと運用上の注意
Arkioが一般に扱うフォーマットと注意点のまとめです。
- SketchUp（.skp）：ジオメトリ中心。グループ／コンポーネントの整理を推奨。
- IFC：属性／階情報を伴うBIMデータに適する。属性マッピングルールを定義する。
- OBJ／FBX：メッシュベースの交換に適す。ポリゴン数とテクスチャを最適化する。
- 共通注意点：単位統一、不要ジオメトリの削除、レイヤとネーミングの整理を事前に行う。
Revit／SketchUp／Rhinoとの同期（導入手順の基本）
プラグインや同期の基本的な流れとテストポイントを示します。
- プラグイン入手：Arkioのプラグイン配布ページから対象プラグインを取得し、対応バージョンを確認する。
- インストールと権限：Revit等へプラグインを導入し、必要に応じて管理者権限で設定する。
- 小規模テスト：サンプルモデルでエクスポートとインポート、またはLive‑linkでの双方向同期を試す。
- 運用ルール：同期の方向（片方向／双方向）、更新タイミング、属性の優先順位を決める。大規模モデルは分割して同期することを推奨。
データ整合性と運用ルール
BIMデータの整合性を保つための実務ルールです。
- 座標原点と単位を統一する。
- 階やレベルのマッピングルールを定義する。
- 属性名・フォーマットの共通辞書を作る。
- 重要変更前に必ずスナップショットを保存する。
- 反映責任者を定め、変更履歴を管理する。
共同運用ルールと運用ワークフロー
共同編集を円滑にするための実務ルールと運用フローを提示します。明確な役割分担と成果物管理ルールが現場の混乱を防ぎます。
役割と権限設定
役割の切り分けと権限運用の実践例です。
- 役割例：ホスト（セッション作成・権限管理）、モデリング担当（編集）、レビュワー（閲覧・注記）、記録担当（議事録）。
- 権限運用：編集は必要最小限に限定。ホストは参加許可と権限付与を管理。
- 招待運用：招待リンクの有効期限や配布フローを定め、管理を徹底する。
議事録とスナップショット運用
成果物の保存と命名規則の例です。
- スナップショット命名例：「YYYYMMDD_プロジェクト名_説明」。
- 議事録テンプレ：プロジェクト名／日付／参加者／決定事項／アクション（担当＋期日）／参照スナップショット。
- 保存ルール：重要変更前は必ずスナップショット保存し、別媒体へエクスポートしてバックアップを取る。
パフォーマンス最適化の運用ルール
大規模モデルでの実務運用上の工夫を示します。
- モデル分割とレイヤ管理で読み込み負荷を下げる。
- LODを用意してレビュー用途で低詳細版を使う。
- ノンビジュアル要素は削除または外部リンク化する。
- 定期的にパフォーマンステストを行い閾値を定める。
トラブルシューティング・導入チェックリスト・ライセンス判断
障害の初動対応、導入前チェックリスト、契約時の確認ポイントを実務視点で整理します。サポートにエスカレーションする前にこの一覧で切り分けを行ってください。
よくあるトラブルと初動対応
トラブルを種類別に分け、初動で行うべき手順を示します。
- 同期遅延／接続切断：全員のArkioバージョンを確認。ネットワーク帯域と遅延を測定。ルータやファイアウォールによる制限を疑う。最小モデルで再現。
- 表示崩れ／インポート失敗：モデルを軽量化して再エクスポート（OBJ/FBXで試す）。テクスチャを外して切り分け。
- クラッシュ：再現手順を記録し、アプリログとシステムログを収集。最新版で再試行。
- トラッキング不良（VR）：コントローラー電池、ファームウェア、Guardian設定を確認。追跡が安定しない場合は別端末で確認。
各ケースで共通して重要なのは「再現手順の明確化」と「ログ一式（端末＋ネットワーク）の収集」です。
導入チェックリスト（実務テンプレ）
パイロット実施前に必ず確認すべき項目です。
ハードウェア・端末
- 使用予定デバイスと充電管理体制を確保。
- テスト用PCのGPUドライバとVRランタイムを最新に。
ネットワーク
- 5GHz Wi‑Fiまたは有線の動作確認。帯域と遅延の計測。
- ファイアウォール・プロキシ設定の影響確認。
ソフトウェア
- Arkio本体とプラグインのバージョン整合。
- 関連ドライバとランタイムの更新。
テスト項目
- 小規模モデルでのインポート→表示テスト。
- 15〜30分の共同編集セッション。
- BIMプラグインでの同期テスト（サンプルモデル）。
- クラッシュ時のログ取得手順の確認。
担当者・スケジュール
- パイロットリーダー、BIM担当、IT担当を決定。
- トレーニングと評価スケジュールを設定。