4. エラー発生手順

4.1. エラーコード 001-0803 の発生手順

エラーコード 001-0803 は、フレンドライブラリが返すエラーです。このエラーコードは、発生原因が「認証サーバへの接続失敗」のため「認証サーバエラーシミュレータ」へ接続した時点で発生させることができません。そのため、下記の手順で発生させます。

  1. 確認したい Nintendo Network対応ソフトで「認証サーバエラーシミュレータ」への接続ができることを確認します。
    ※    このとき、認証サーバエラーシミュレータでは、「002-XXXX」のエラーを設定してください。「003-XXXX」を設定した状態では、エラーコード 001-0803 が発生しません。
  2. アクセスポイントの設定からパケットフィルタを用いて「認証サーバエラーシミュレータ」へのパケットを送信しないように設定します。製品用は「202.32.117.155」宛て、テスト用は「202.32.117.156」宛ての TCP ポート 443 番のパケットの送信を停止します。
  3. 確認したい Nintendo Network対応ソフトで認証処理を試みます。

 

 

4.2. エラーコード 002-XXXX の発生手順

  1. アクセスポイントの DNS 設定を変更し、認証サーバエラーシミュレータへの接続設定を行います。
  2. PC から認証サーバエラーシミュレータへ接続し、「表 2 1 設定可能な認証エラー一覧」を参考に発生させたいエラーコードを設定します。
  3. 3DS 本体のネットワーク設定から、項目1で設定したアクセスポイントを接続先に設定します。
  4. 確認したい Nintendo Network 対応ソフトで認証処理を試みます。
    ※    項目1および2の詳細な設定方法は「2 認証サーバエラーシミュレータの使用方法」を参照してください。

 

 

4.3. エラーコード 003-XXXX の発生手順

4.3.1. ツールによるエラーコードの発生手順

パッケージに同梱されているツール NZSimulator.cia を使用して確認できるのは、「ニンテンドーゾーンやホットスポットで、接続が制限されているアプリから接続しようとした場合に発生するエラー」です。開発機材で NZSimulator.cia を動作させることで、このエラーを発生させる環境を用意できます。このエラーのエラーコードは、3DS 本体のファームウェアのバージョンによって異なります。「図 4-1. 本体ファームウェアのバージョンと発生するエラーコード」を参照してください。

図 4-1. 本体ファームウェアのバージョンと発生するエラーコード
本体ファームウェアのバージョン 発生するエラーコード

0.15.0 以降

003-3305

0.14.24 以前

003-3505

4.3.1.1. 開発機材を使用してツールを動作させる手順

NZSimulator.cia を使用するためには、テストしたいアプリを動作させる 3DS とは別に、開発機材を用意する必要があります。また、開発機材には DS ソフト用のインターネット接続設定を行う必要があります。NZSimulator.cia のインポート方法については、本パッケージの Readme を参照してください。

NZSimulator.cia は、下記の手順で使用します。

  1. 開発機材の HOME メニューから「本体設定」を選択し、「インターネット設定」→「DSソフト用設定」で、インターネットに接続するアクセスポイントを設定します。
    • 「DSソフト用設定」を行うには、TEST メニューではなく HOME メニューから「本体設定」を起動する必要があります。
  2. エラーを確認したいソフトを起動する 3DS の接続先 1 ~ 3 の設定を消去するか、SSID を変更することで、アクセスポイントに接続しないようにします。
  3. 1.で設定した 開発機材で NZSimulator を起動します。NZSimulator を起動すると、エラーが発生するニンテンドーゾーンの信号が発信されます。
  4. 3DS から、開発機材が親機となったニンテンドーゾーンに接続します。
    • ニンテンドーゾーンへの接続は自動で行われます。
  5. エラーを確認したいソフトを 3DS の HOME メニューから起動し、インターネットへの接続を試みます。
    • 電波環境が悪い場合、ニンテンドーゾーンへ接続できず、接続先が見つからないエラー(003-1099)が発生する可能性があります。
    • nn::uds::Finalize() や nn::ndm::SuspendScheduler() などを実行した直後は、ネットワークデーモンがバックグラウンドの接続を確立できていません。このときに nn::ac::Connect() を実行すると、本ツールを使用している状態では、エラーコード 003-1099 が発生します。この挙動は仕様のため、上記のような実装になっている場合、エラーコード 003-3305 が発生しなくても問題はありません。
    • 意図したエラーが表示されない場合には NZSimulator を動作させている開発機材の無線スイッチが ON になっているか確認してください。NZSimulator の起動後に無線スイッチを ON にすることはできません。無線スイッチが OFF になっている場合は、一度 NZSimulator を終了させて無線スイッチを ON にしてから、再度 NZSimulator を立ち上げてください。

 

 

4.3.2. その他のエラーコードの発生手順

エラーコード 003-XXXX 番台のその他のエラー再現方法につきましては、「CTR ネットワークエラーコードリスト」 (CTR_Network_ErrorCodeList.xls) を参照してください。

4.4. エラーコード 006-XXXX の発生手順

NEX ライブラリ使用ソフトは、認証処理を行ったあと、プレゼンス機能やマッチメイク機能などを使用するために、NEX ライブラリによるゲームサーバーへの接続を行います。NEX ライブラリによるゲームサーバーへの接続で発生するエラーの確認では、認証サーバエラーシミュレータは使用しません。

以下にそれぞれのエラーコードに対応するエラーの発生手順を示します。

NEX の機能として nn::nex::IndependentServer::RequestAuthenticationToken 関数のみ使用するソフトの場合、NEX のゲームサーバーへのアクセスは発生せず、以下のエラーは発生しません。そのため、「表 4-1. エラーコード 006-XXXX の発生手順」のエラーコードを確認する必要はありません。

表 4-1. エラーコード 006-XXXX の発生手順
エラーコード エラー内容/発生手順
006-0502

ゲームサーバーへの接続が確立できない場合に発生します。

  1. 確認したい NEX ライブラリ使用ソフトで、ゲームサーバーへ接続できることを確認します。
  2. OMAS から、確認したい NEX ライブラリ使用ソフトの「NEX サーバ」の項目を参照し、記載されているグローバル IP アドレスを確認します。
  3. アクセスポイントの設定からパケットフィルタを用いて、2.で確認した IP アドレス宛てのパケット送信を停止します。
    ※    IP アドレスは、ソフト毎に異なります。
  4. 確認したい NEX ライブラリ使用ソフトでゲームサーバーへの接続を試みます。
006-0612

P2P セッションへの参加に失敗した場合に発生します。

エラーコード 006-0612 は、NEX のマッチメイク機能を使用し、P2P 通信で NEX の NetZ ライブラリを使用するソフトでのみ発生します。

  1. マッチメイクを行うために、2 台の 3DS(CTR A, CTR B)を用意します。
  2. CTR A が使用するグローバル IP アドレスを確認します。
  3. CTR B が使用するアクセスポイントの設定からパケットフィルタを用いて、2.で確認した IP アドレス宛て(CTR A 宛て)のパケット送信を停止します。
  4. CTR A と CTR B でマッチメイクを行い、P2P セッションへの参加を試みます。

また、NEX のバージョンが 2.x 以下であれば、以下の方法でも 006-0612 を発生させることができます。

  1. 確認したい NEX ライブラリ使用ソフトで、マッチメイクできることを確認します。
  2. アクセスポイントの設定からパケットフィルタを用いて、「202.32.117.142」と、「202.32.117.143」宛てのパケット送信を停止します。
  3. 確認したいNEX ライブラリ使用ソフトでマッチメイクを行い、P2P セッションへの参加を試みます。
補足:

P2P 通信で Pia ライブラリを使用している場合は、本項目の手順で 006-0612 ではなく「図 4-2. Pia ライブラリを使用する場合に発生するエラーコード」のようなエラーが発生します。このとき発生するエラーコードは、ネットワーク環境の NAT タイプによって異なります。Pia ライブラリで発生する各エラーコードの NAT タイプについては、CTR ネットワークエラーコードリストを参照してください。

図 4-2. Pia ライブラリを使用する場合に発生するエラーコード
Pia 3.6.0 より前のバージョン Pia 3.6.0 以降のバージョン
018-0201 018-0201
018-0510 018-0510
018-0511 018-0513
018-0512 018-0514
  018-0515
  018-0516
006-0811

ゲームサーバーがメンテナンス中の場合に発生します。

エラーコード 006-0811 を確認するためには、NEX ライブラリ使用ソフトのゲーム ID とアクセスキーを一時的に変更する必要があります。確認のために変更するゲーム ID は、「表 4-2. NEX のバージョンとゲーム ID」 の通り、アプリが使用している NEX のバージョンによって異なります。ゲーム ID の末尾は、使用している NEX のメジャーバージョンの値マイナス 1 の値を設定してください。

独自サーバを併用する場合、キーハッシュ値には NEX のサンプルデモサーバと同様の値「deed2a88」を設定してください。

表 4-2. NEX のバージョンとゲーム ID
NEX のバージョン ゲーム ID アクセスキー

2.x

0x0FE00701

50671b47

3.0~3.6

0x0FE00702

50671b47

3.7以降

0x0FE00703

任意 

  1. 確認したい NEX ライブラリ使用ソフトのゲーム ID とアクセスキーを、使用している NEX のバージョンに合わせて変更します。
  2. ゲームサーバーへの接続を試みます。
    ※    確認後は、変更した値を必ず本来割り当てられている値に戻してください。
その他のエラーコード 現在、006-XXXX 番台のその他のエラーについては、確認する必要はありません。

4.5. エラーコード 015-XXXX の発生手順

エラーコード 015-XXXX は発生原因が OLV 関連の場合に発生するエラーです。

以下にそれぞれのエラーコードに対応するエラーの発生手順を示します。

表 4-3. エラーコード 015-XXXX の発生手順
エラーコード エラー内容/発生手順
015-1002

ペアレンタルコントロールでMiiverse の利用を制限されており、Miiverse の閲覧/投稿ができないため発生します。

  1. 3DS のペアレンタルコントロール設定で「Miiverse の使用」「投稿・閲覧を制限する」を選択してください。
  2. Miiverse の閲覧または投稿機能を利用するシーンに入り、エラーコードが発生することを確認してください。
015-1003

ペアレンタルコントロールで Miiverse の投稿を制限されており、Miiverse の投稿ができないため発生します。

  1. 3DS のペアレンタルコントロール設定で「Miiverse の使用」「投稿のみ制限する」を選択してください。
  2. Miiverse の投稿機能を利用するシーンに入り、エラーコードが発生することを確認してください。
015-5003

サーバーがメンテナンス中のため発生します。

  1.  "5003-" で始まるニンテンドーネットワーク ID のネットワークアカウントを準備してください。
  2.  Miiverse の機能を利用するシーンに入り、エラーコードが発生することを確認してください。

※製品環境では、この手順でエラーは発生しません。

015-5110

投稿や取得をしようとした公式コミュニティが存在しないため発生します。

※本エラーは、投稿前に公式コミュニティの一覧を取得し、投稿対象のコミュニティが存在するかをチェックしている場合には、以下の手順では発生しない場合があります。

デフォルト公式コミュニティは開発環境では初回の投稿時に自動的に作成されます。そのため、このエラーを意図的に確認するための環境を用意しています。ユニークID / OLVアクセスキーを一時的に以下の表のように変更してください。将来的にはアプリケーション開発者側で自由に公式コミュニティの情報を変更する方法を提供する予定です。

また、独自サーバーを利用するタイトルでサービストークンを取得するためには、ユニークID に紐づけられたクライアントID を使用する必要があります。サービストークンの取得が行われないと Miiverse の投稿機能を使用するシーンに入れないタイトルの場合には、以下の表のようにクライアントID を設定して本テストを行ってください。 クライアントID は独自サーバーを利用しないタイトルの場合には設定する必要はありません。

ユニークID OLVアクセスキー クライアントID
0xFE04B 2846053188 fc32546f4fb14b699af35cc31b1a4b30
  1. 確認したい Miiverse 対応ソフトのユニークID / OLVアクセスキーを上記の値に変更します。
  2. Miiverse の投稿機能を利用するシーンに入り、エラーコードが発生することを確認してください。

※確認後は、必ずユニークID、 OLVアクセスキー 、クライアントID を本来割り当てられている値に戻してください。

4.6. エラーコード 022-XXXX の発生手順

エラーコード 022-XXXX は発生原因がアカウント関連の場合に発生するエラーです。

以下にそれぞれのエラーコードに対応するエラーの発生手順を示します。

 

表 4-4. エラーコード 022-XXXX の発生手順
エラーコード エラー内容/発生手順
022-2503

最新の EULA に同意していないときに発生します。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID を選択し、そのユーザーのダッシュボードに遷移してください。

  2. ダッシュボードの ”アクション” で、選択肢の中から "EULAの同意履歴" を選択し、同意済み EULA の管理画面に遷移してください。

  3. 任意の同意済み EULA に対して、"リセット" ボタンを押し、EULA への同意を取り消してください。
  4. 3DS 本体を再起動し、該当アプリケーションで以下の API を実行し、エラーコードが発生することを確認してください。
    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()
    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
    • ECアプレット初期化関数 nn::ec::CTR::EcApplet::RequestInitializeSession()
022-2512

アプリケーションの更新が必要な場合に発生します。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID を選択し、そのユーザーのダッシュボードに遷移してください。
  2. ダッシュボードの”アクション” で、選択肢の中から "アプリケーションのテスト設定" を選択し、アプリケーションのテスト用の画面に遷移してください。
  3. "テスト設定を追加する" ボタンを押し、テスト設定を追加する画面に遷移してください。
  4. "テスト項目" の項目に "バージョンアップ通知" を選択し、"アプリケーション" の項目にテストしたいタイトルを選択しセットしてください。
  5. "追加" ボタンを押し、アプリケーションのテスト設定画面に遷移し "アプリケーションのテスト設定を追加しました。" という文字が表示されていることを確認してください。
  6. 3DS 本体を再起動し、該当アプリケーションで以下のサービストークンを取得する API を実行し、エラーコードが発生することを確認してください。
    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()
    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
022-2631

他の端末からネットワークアカウントを削除した場合に発生します。

この作業を行うと、ニンテンドーネットワークID の利用ができなくなりますので注意してください。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID の右側にある "削除" ボタンを押下してください。
  2. 確認画面が表示されますので、"削除" ボタンを押下してください。
  3. "成功" という文字が表示されることを確認してください。
  4. 3DS 本体を再起動し、該当アプリケーションで以下の API を実行し、エラーコードが発生することを確認してください。
    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()
    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
    • ECアプレット初期化関数 nn::ec::CTR::EcApplet::RequestInitializeSession()
022-2803

指定したユニーク ID でのネットワークサービスの利用が、アカウント単位で停止されている場合に発生します。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID を選択し、そのユーザーのダッシュボードに遷移してください。
  2. ダッシュボードの ”アクション” で、選択肢の中から "BAN管理" を選択し、ユーザーアカウントのBan設定の画面に遷移してください。
  3. "BANする" ボタンを押して、BAN(サービスの利用を禁止)する画面に遷移してください。
  4. "タイプ" の項目に、"タイトル別アカウントBAN" を選択してください。
  5. "3DS タイトル" の項目が表示されるので、目的のタイトルを選択してください。
  6. "登録する" ボタンを押し、BAN設定画面に遷移し "BAN(サービスの利用を禁止)しました。" という文字が表示されていることを確認してください。
  7. 3DS 本体を再起動し、該当アプリケーションで以下のサービストークンを取得する API を実行し、エラーコードが発生することを確認してください。
    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()
    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
022-2812

全てのネットワークサービスの利用がデバイス単位で停止されている場合に発生します。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID を選択し、そのユーザーのダッシュボードに遷移してください。
  2. ダッシュボードの ”結び付いているデバイス” から目的のデバイスを選択し、そのデバイスのダッシュボードに遷移してください。
  3. ダッシュボードの ”アクション” から  "BAN管理" を選択し、デバイスのBan設定の画面に遷移してください。
  4. "BAN(サービスの利用を禁止)する" ボタンを押して、BAN(サービスの利用を禁止)する画面に遷移してください。
  5. "タイプ" の項目に、"デバイスBAN" を選択してください。
  6. "登録する" ボタンを押し、BAN設定画面に遷移し "BAN(サービスの利用を禁止)しました。" という文字が表示されていることを確認してください。
  7. 3DS 本体を再起動し、該当アプリケーションで以下の API を実行し、エラーコードが発生することを確認してください。
    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()
    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
    • ECアプレット初期化関数 nn::ec::CTR::EcApplet::RequestInitializeSession()
022-2813

指定したユニーク ID でのネットワークサービスの利用が、デバイス単位で停止されている場合に発生します。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID を選択し、そのユーザーのダッシュボードに遷移してください。
  2. ダッシュボードの ”結び付いているデバイス” から目的のデバイスを選択し、そのデバイスのダッシュボードに遷移してください。
  3. ダッシュボードの ”アクション” から "BAN管理" を選択し、デバイスの Ban 設定の画面に遷移してください。
  4. "BAN(サービスの利用を禁止)する" ボタンを押して、BAN(サービスの利用を禁止)する画面に遷移してください。
  5. "タイプ" の項目に、"タイトル別デバイスBAN" を選択してください。
  6. "3DS タイトル" の項目が表示されるので、目的のタイトルを選択してください。
  7. "登録する" ボタンを押し、BAN設定画面に遷移し "BAN(サービスの利用を禁止)しました。" という文字が表示されていることを確認してください。
  8. 3DS 本体を再起動し、該当アプリケーションで以下のサービストークンを取得する API を実行し、エラーコードが発生することを確認してください。

    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()

    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
022-2881

サービスがメンテナンス中の場合に発生します。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID を選択し、そのユーザーのダッシュボードに遷移してください。
  2. ダッシュボードの ”アクション” で、選択肢の中から "アプリケーションのテスト設定" を選択し、アプリケーションのテスト用の画面に遷移してください。
  3. "テスト設定を追加する" ボタンを押し、テスト設定を追加する画面に遷移してください。
  4. "テスト項目" の項目に "メンテナンス通知" を選択し、"アプリケーション" の項目にテストしたいタイトルを選択しセットしてください。
  5. "追加" ボタンを押し、アプリケーションのテスト設定画面に遷移し "アプリケーションのテスト設定を追加しました。" という文字が表示されていることを確認してください。
  6. 3DS 本体を再起動し、該当アプリケーションで以下のサービストークンを取得する API を実行し、エラーコードが発生することを確認してください。
    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()
    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
022-2882

サービスがすでに終了している場合に発生します。

  1. Account Developer Portal のテスト用 ID 管理画面で目的のニンテンドーネットワーク ID を選択し、そのユーザーのダッシュボードに遷移してください。
  2. ダッシュボードの ”アクション” で、選択肢の中から "アプリケーションのテスト設定" を選択し、アプリケーションのテスト用の画面に遷移してください。
  3. "テスト設定を追加する" ボタンを押し、テスト設定を追加する画面に遷移してください。
  4. "テスト項目" の項目に "サービス終了通知" を選択し、"アプリケーション" の項目にテストしたいタイトルを選択しセットしてください。
  5. "追加" ボタンを押し、アプリケーションのテスト設定画面に遷移し "アプリケーションのテスト設定を追加しました。" という文字が表示されていることを確認してください。
  6. 3DS 本体を再起動し、該当アプリケーションで以下のサービストークンを取得する API を実行し、エラーコードが発生することを確認してください。
    • 独自サーバー用トークン取得 API nn::act::applet::AcquireIndependentServiceToken()
    • Miiverse用トークン取得 API nn::act::applet::AcquireOlvServiceToken()
補足:

EC アプレット起動時のニンテンドーネットワーク ID 認証では、特定のアプリケーションに向けて Account Developer Portal の設定を行った場合にエラー(022-2803, 022-2813, 022-2881, 022-2882)は発生しません。これはニンテンドーネットワーク ID の認証を行う主体が、アプリケーションではなく EC アプレットになっているためです。