Difference between revisions of "ビューワ引数"
Mako Nozaki (talk | contribs) (on half way) |
Mako Nozaki (talk | contribs) (completed) |
||
Line 1: | Line 1: | ||
{{Help/ja|Viewer=*}} | {{Help/ja|Parent=Viewer parameters|Viewer=*}} | ||
バージョン 1.20 より前の Second Life の場合はこちらを参照: [[Pre 1.20 Client parameters]] | バージョン 1.20 より前の Second Life の場合はこちらを参照: [[Pre 1.20 Client parameters]] | ||
Line 67: | Line 67: | ||
注意: ''仮引数'' はコマンドラインの中でダブルダッシュ (--) に続けて記述される命令を指します。''実引数'' は (仮) 引数に指定される値です。例えば、<code>--port 13001</code> では、"port" は仮引数で、"13001" は実引数です。 | 注意: ''仮引数'' はコマンドラインの中でダブルダッシュ (--) に続けて記述される命令を指します。''実引数'' は (仮) 引数に指定される値です。例えば、<code>--port 13001</code> では、"port" は仮引数で、"13001" は実引数です。 | ||
( | {| {{Prettytable}} | ||
|-{{Hl2}} | |||
! 仮引数 | |||
! 実引数 (ある場合) | |||
! 説明 | |||
! 上書きされる設定 | |||
|- | |||
| --autologin | |||
| なし | |||
| 最後に保存したユーザでログインします。 | |||
| AutoLogin | |||
|- | |||
| --channel <チャネル名> | |||
| チャネル名 | |||
| チャネル名のバージョンを指定します。 (テスト用) | |||
| VersionChannelName | |||
|- | |||
| --console <show> | |||
| TRUE '' または '' '''FALSE''' | |||
| デバッグコンソールを表示します。 (Windows のみ) | |||
| ShowConsoleWindow | |||
|- | |||
| --cooperative <明け渡すミリ秒> | |||
| ミリ秒/フレーム | |||
| フレーム単位で指定した時間をホストに明け渡します。 | |||
| YieldTime | |||
|- | |||
| --crashonstartup | |||
| なし | |||
| 起動時に強制終了させます。デバッグ用です。 | |||
| なし | |||
|- | |||
| --debugviews | |||
| なし | |||
| デバッグ情報の UI ビューを使用できるようにします。 | |||
| DebugViews | |||
|- | |||
| --drop <確率> | |||
| ドロップ確率 (0 - 100) | |||
| パケットをドロップさせる割合を指定します。 | |||
| PacketDropPercentage | |||
|- | |||
| --god | |||
| なし | |||
| 権限がある場合、[[God Mode|ゴッドモード]] でログインします。 | |||
| ConnectAsGod | |||
|- | |||
| --grid <グリッド選択> | |||
| グリッド名または IP アドレス | |||
| 接続先グリッドを指定します。IP アドレスでも指定できます。 | |||
| GridChoice | |||
|- | |||
| --help | |||
| なし | |||
| 指定可能なオプションがリストアップされたメッセージボックスを表示します。 | |||
| なし | |||
|- | |||
| --helperuri <URI> | |||
| URI | |||
| 使用するヘルプの CGI プレフィックス ??? | |||
| HelperURI | |||
|- | |||
| --ignorepixeldepth | |||
| なし | |||
| ピクセル深度を無視します。 | |||
| IgnorePixelDepth | |||
|- | |||
| --inbw <ビット/秒> | |||
| ビット/秒 | |||
| 入力最大帯域幅を指定します。 | |||
| InBandwidth | |||
|- | |||
| --loginpage <URL> | |||
| ページの URL | |||
| 使用するログインページ | |||
| | |||
|- | |||
| --loginuri <URI> | |||
| URI | |||
| 接続先ログインサーバ | |||
| LoginURI | |||
|- | |||
| --log | |||
| なし | |||
| ネットワークトラフィックを記録します。 | |||
| LogMessages | |||
|- | |||
| --logfile <ファイル名> | |||
| ファイル名 | |||
| ログの出力先ファイル名を指定します。 | |||
| UserLogFile | |||
|- | |||
| --login <ファースト・ネーム> <ラスト・ネーム> <パスワード> | |||
| ログインに使用するアカウントのファースト・ネーム、ラスト・ネーム、パスワード | |||
| ログインに使用する値を指定します。 | |||
| UserLoginInfo | |||
|- | |||
| --multiple | |||
| なし | |||
| 複数のビューアが同時に起動していることを許可します。 | |||
| AllowMultipleViewers | |||
|- | |||
| --noaudio | |||
| なし | |||
| クライアントから音が出ないようにします。 | |||
| NoAudio | |||
|- | |||
| --noinvlib | |||
| なし | |||
| 持ち物ライブラリをリクエストしません。 | |||
| NoInventoryLibrary | |||
|- | |||
| --no-verify-ssl-cert | |||
| なし | |||
| SSL の証明書を検証しません。 | |||
| NoVerifySSLCert | |||
|- | |||
| --nopreload | |||
| なし | |||
| クライアントで使用するサウンドやビットマップの事前ロードを行いません。 | |||
| NoPreload | |||
|- | |||
| --noprobe | |||
| なし | |||
| 起動時にハードウェアのチェックを行いません。 | |||
| NoHardwareProbe | |||
|- | |||
| --noquicktime | |||
| なし | |||
| クライアントで Quicktime を使用しません。 | |||
| NoQuickTime | |||
|- | |||
| --nosound | |||
| なし | |||
| クライアントから音が出ないようにします。 | |||
| NoAudio | |||
|- | |||
| --novoice | |||
| なし | |||
| ボイスチャットを無効にします。 | |||
| DisableVoice | |||
|- | |||
| --outbw <ビット/秒> | |||
| ビット/秒 | |||
| 出力最大帯域幅を指定します。 | |||
| OutBandwidth | |||
|- | |||
| --purge | |||
| なし | |||
| 起動時にクライアントにダウンロードキャッシュをクリアさせます。 | |||
| PurgeCacheOnNextStartup | |||
|- | |||
| --port <ポート番号> | |||
| ポート番号 | |||
| クライアントが使用する TCP ポートを設定します。同じローカルホームネットワークで SL を複数起動するときに役に立ちます。13000 と 13001 のようにして指定することになるでしょう。(指定できる範囲は 13000 から 13050 です) | |||
| ViewerPort | |||
|- | |||
| --qa | |||
| なし | |||
| テストのための UI フィーチャーを有効にします。 | |||
| QAMode | |||
|- | |||
| --quitafter <秒> | |||
| 終了するまでに待機する秒数 | |||
| 指定した時間待ってからクライアントを終了させます。 | |||
| QuitAfterSeconds | |||
|- | |||
| --rotate | |||
| なし | |||
| アバターを右に向かせます。 (テスト用) | |||
| RotateRight | |||
|- | |||
| --safe | |||
| なし | |||
| 設定をリセットしてからセーフモードで起動します。 | |||
| SafeMode | |||
|- | |||
| --set <パラメタ> <値> | |||
| 第一引数は設定名、第二引数はそれに設定する値 | |||
| 指定した設定に設定する値を指定します。 | |||
| <パラメタ> に対応する設定 | |||
|- | |||
| --settings <ファイル名> | |||
| ローカルファイル名 | |||
| ユーザ設定ファイルの名前を指定します。 | |||
| UserSettingsFile | |||
|- | |||
| --skin <フォルダ> | |||
| フォルダ名 | |||
| 使用するスキンフォルダを指定します。 (korean, spanish など) | |||
| SkinFolder | |||
|- | |||
| --url <SLurl> | |||
| SLurl | |||
| 開始する地域と位置を指定します。(例えば、secondlife://Ahern/128/128) | |||
これはコマンドラインの最後の引数でなければなりません。 | |||
| SecondLifeURL | |||
|} | |||
== 新しいコマンドライン引数を指定する == | |||
新しいコマンドライン引数を追加するには、設定ファイル ''app_settings/cmd_line.xml'' を使用してコマンドライン引数とユーザ設定を関連づけます。 | |||
1 つのパラメタは次のオプションをもつことができます。 | |||
* desc - パラメタの説明。 | |||
* short - パラメタに関連づく 1 文字のキャラクター。 | |||
* count - オプションに続くトークンの数。 | |||
* compose - オプションを複数回指定することができる場合は true 。 | |||
* positional - --name を指定しなくてもオプションを指定できる場合は true 。 | |||
* last_option - オプションが最後のオプションでなければならない場合は true 。 | |||
* map-to - オプションを関連づけるユーザ設定。 | |||
ファイルは [[LLSD]] 構文を使用します。既にあるオプションを参考にしてください。 |
Revision as of 21:15, 24 April 2010
バージョン 1.20 より前の Second Life の場合はこちらを参照: Pre 1.20 Client parameters
ビューア引数を使用する
ビューアにコマンドライン引数を渡す方法はたくさんあります。
コマンドライン
全てのプラットフォームで、コマンドシェルからビューアを起動すればコマンドラインから引数を直接指定することができます。例えば、
SecondLife.exe --channel "Test 123" --settings settings_workspace.xml --set InstallLanguage ja
Windows ショートカット
Windows では、次のようにしてコマンドライン引数を指定することもできます。
- SecondLife.exe 実行可能ファイルのショートカットを作成します。
- ショートカットのプロパティを編集します。
- 先頭の編集可能なテキストフィールドの中に下記の引数を追加します。
- 引数は行の最後、引用符がある場合はその後に追加します。
Linux
Linux では、コマンドライン引数を次のようにして指定します。
- Second Life フォルダの中の gridargs.dat ファイルをテキストエディタで編集します。
- 下記の引数をファイルに追加します。スペースか改行で区切ります。
- ファイルを保存します。
Second Life が次回起動されたときに、指定された引数が使われるようになります。
Mac OS X パラメタファイル
Mac OS X では、コマンドライン引数を次のようにして指定します。
- Second Life.app/Contents/Resources/arguments.txt という名前のファイルを作成します。
- 1 行に 1 個ずつ使用する引数を書き並べます。
Second Life が次回起動されたときに、指定されたオプションが使われるようになります。
Mac OS X AppleScripts
Second Life をコマンドライン引数を使って起動する別の (そしてより簡単な) 方法は、AppleScript を使う方法です。
次の手順を実行してください:
-
/アプリケーション/AppleScript
でスクリプト編集プログラムを開きます。 - 新しい文書を開き、次のテキストを貼り付けます:
do shell script "\"/Applications/Second Life.app/Contents/MacOS/Second Life\" -grid Aditi"
このスクリプトにはサンプルとして、ベータグリッドにログインする引数が入っています。お好きなように引数を変更してください。
- いい感じに引数を書き終えたら、「コンパイル」をクリックします。
- ファイル > 別名で保存を選択します。
- スクリプトをアプリケーションとして保存し、「実行専用で保存」(OS X.4 Tiger ではたぶん「実行」) を選択します。スクリプトを調整したい場合は実行専用でないものとして保存することもできますし、コピーを「コンパイル済みスクリプト」として保存することもできます。
コンパイルしたアプリケーションをダブルクリックして、ビューアを指定した引数で起動します。
注意: もしビューアが起動してすぐに終了したら、通常の方法で起動してください。更新が入手可能となっている可能性が高いからです。ダウンロードするとスクリプトが再び動作するようになります。これに関しては、JIRA issue で言及されています。
Visual Studio
Visual Studio では、コマンドライン引数は newview プロジェクトのプロパティのオプション-デバッグタブで指定できます。newview がスタートアッププロジェクトに設定されていることを確認し、コンパイルされたビューアをデバッガで起動すると、これらのオプションが有効となります。
XCode
XCode では、"実行可能ファイル" グループから "newview" を選択します。そして、「情報を見る」でダイアログを開き、「引数」タブをクリックします。「起動時に渡される引数」の中に下記のオプションを追加していきます。
引数リファレンス
注意: 仮引数 はコマンドラインの中でダブルダッシュ (--) に続けて記述される命令を指します。実引数 は (仮) 引数に指定される値です。例えば、--port 13001
では、"port" は仮引数で、"13001" は実引数です。
仮引数 | 実引数 (ある場合) | 説明 | 上書きされる設定 |
---|---|---|---|
--autologin | なし | 最後に保存したユーザでログインします。 | AutoLogin |
--channel <チャネル名> | チャネル名 | チャネル名のバージョンを指定します。 (テスト用) | VersionChannelName |
--console <show> | TRUE または FALSE | デバッグコンソールを表示します。 (Windows のみ) | ShowConsoleWindow |
--cooperative <明け渡すミリ秒> | ミリ秒/フレーム | フレーム単位で指定した時間をホストに明け渡します。 | YieldTime |
--crashonstartup | なし | 起動時に強制終了させます。デバッグ用です。 | なし |
--debugviews | なし | デバッグ情報の UI ビューを使用できるようにします。 | DebugViews |
--drop <確率> | ドロップ確率 (0 - 100) | パケットをドロップさせる割合を指定します。 | PacketDropPercentage |
--god | なし | 権限がある場合、ゴッドモード でログインします。 | ConnectAsGod |
--grid <グリッド選択> | グリッド名または IP アドレス | 接続先グリッドを指定します。IP アドレスでも指定できます。 | GridChoice |
--help | なし | 指定可能なオプションがリストアップされたメッセージボックスを表示します。 | なし |
--helperuri <URI> | URI | 使用するヘルプの CGI プレフィックス ??? | HelperURI |
--ignorepixeldepth | なし | ピクセル深度を無視します。 | IgnorePixelDepth |
--inbw <ビット/秒> | ビット/秒 | 入力最大帯域幅を指定します。 | InBandwidth |
--loginpage <URL> | ページの URL | 使用するログインページ | |
--loginuri <URI> | URI | 接続先ログインサーバ | LoginURI |
--log | なし | ネットワークトラフィックを記録します。 | LogMessages |
--logfile <ファイル名> | ファイル名 | ログの出力先ファイル名を指定します。 | UserLogFile |
--login <ファースト・ネーム> <ラスト・ネーム> <パスワード> | ログインに使用するアカウントのファースト・ネーム、ラスト・ネーム、パスワード | ログインに使用する値を指定します。 | UserLoginInfo |
--multiple | なし | 複数のビューアが同時に起動していることを許可します。 | AllowMultipleViewers |
--noaudio | なし | クライアントから音が出ないようにします。 | NoAudio |
--noinvlib | なし | 持ち物ライブラリをリクエストしません。 | NoInventoryLibrary |
--no-verify-ssl-cert | なし | SSL の証明書を検証しません。 | NoVerifySSLCert |
--nopreload | なし | クライアントで使用するサウンドやビットマップの事前ロードを行いません。 | NoPreload |
--noprobe | なし | 起動時にハードウェアのチェックを行いません。 | NoHardwareProbe |
--noquicktime | なし | クライアントで Quicktime を使用しません。 | NoQuickTime |
--nosound | なし | クライアントから音が出ないようにします。 | NoAudio |
--novoice | なし | ボイスチャットを無効にします。 | DisableVoice |
--outbw <ビット/秒> | ビット/秒 | 出力最大帯域幅を指定します。 | OutBandwidth |
--purge | なし | 起動時にクライアントにダウンロードキャッシュをクリアさせます。 | PurgeCacheOnNextStartup |
--port <ポート番号> | ポート番号 | クライアントが使用する TCP ポートを設定します。同じローカルホームネットワークで SL を複数起動するときに役に立ちます。13000 と 13001 のようにして指定することになるでしょう。(指定できる範囲は 13000 から 13050 です) | ViewerPort |
--qa | なし | テストのための UI フィーチャーを有効にします。 | QAMode |
--quitafter <秒> | 終了するまでに待機する秒数 | 指定した時間待ってからクライアントを終了させます。 | QuitAfterSeconds |
--rotate | なし | アバターを右に向かせます。 (テスト用) | RotateRight |
--safe | なし | 設定をリセットしてからセーフモードで起動します。 | SafeMode |
--set <パラメタ> <値> | 第一引数は設定名、第二引数はそれに設定する値 | 指定した設定に設定する値を指定します。 | <パラメタ> に対応する設定 |
--settings <ファイル名> | ローカルファイル名 | ユーザ設定ファイルの名前を指定します。 | UserSettingsFile |
--skin <フォルダ> | フォルダ名 | 使用するスキンフォルダを指定します。 (korean, spanish など) | SkinFolder |
--url <SLurl> | SLurl | 開始する地域と位置を指定します。(例えば、secondlife://Ahern/128/128)
これはコマンドラインの最後の引数でなければなりません。 |
SecondLifeURL |
新しいコマンドライン引数を指定する
新しいコマンドライン引数を追加するには、設定ファイル app_settings/cmd_line.xml を使用してコマンドライン引数とユーザ設定を関連づけます。 1 つのパラメタは次のオプションをもつことができます。
- desc - パラメタの説明。
- short - パラメタに関連づく 1 文字のキャラクター。
- count - オプションに続くトークンの数。
- compose - オプションを複数回指定することができる場合は true 。
- positional - --name を指定しなくてもオプションを指定できる場合は true 。
- last_option - オプションが最後のオプションでなければならない場合は true 。
- map-to - オプションを関連づけるユーザ設定。
ファイルは LLSD 構文を使用します。既にあるオプションを参考にしてください。