DWC_NdInitAsync

構文

#include <dwc.h>
BOOL DWC_NdInitAsync(DWCNdCallback callback,
                     const char *gamecd,
                     const char *passwd);

引数

callback ダウンロードライブラリが各種通知時に呼び出すコールバック関数へのポインタ。必ず指定して下さい。
gamecd ダウンロードサーバへのアクセス時に必要となる接続用ゲームコード(文字列)へのポインタ
passwd ダウンロードサーバへのアクセス時に必要となるゲーム用パスワード(文字列)へのポインタ

返り値

TRUE 成功。初期化処理終了時にコールバック関数が呼び出されます。
FALSE 失敗。DWC_GetLastErrorEx関数を使用してエラーの情報を取得してください

説明

ダウンロードライブラリの初期化処理を開始します。
初期化処理はバックグラウンドでHTTP通信を行いますので、処理中はメインスレッドよりも優先度の低いスレッドに十分な処理時間が渡るようにしてください。なお、ダウンロードサーバは、開発向けと製品向けの2種類が提供されますが、この切り替えはDWC_InitForDevelopment/DWC_InitForProduction関数による認証サーバの切り替えにあわせて行なわれます。

引数として指定するgamecdおよびpasswdに関しては、弊社へのダウンロードサーバの利用申請後に発行されます。

本関数を呼び出しでTRUEが返された後、処理を進めるためにDWC_NdProcess関数を毎ゲームフレーム程度の頻度で呼び出してください。

初期化完了は本関数の引数で指定したDWCNdCallback型のcallbackで知ることができます。

返り値にTRUEが返された時点からダウンロードライブラリは開始していますので、初期化の非同期処理中にエラーが発生した場合も、DWC_NdCleanupAsync関数を呼ぶ必要があります。

本APIは、内部でTWL-SDKWi-FiライブラリのNHTTPStartup関数を呼び出します。本APIを呼び出してからDWC_NdCleanupAsync関数により処理が完了するまでの前後で、重複してNHTTPを使用しないようにしてください。

ダウンロード速度に関して、デフォルトの受信ウィンドウサイズでは、大きなサイズのファイルをダウンロードする際、パフォーマンスが悪くなります。
DWC_SetRwinSize関数を使って、アプリ毎に適切な受信ウィンドウサイズを設定しておくようにして下さい。

参照

DWCNdCallback DWC_GetLastErrorEx DWC_NdProcess DWC_SetRwinSize

履歴

5.3
認証サーバの切り替えを、DWC_SetAuthServer関数ではなくDWC_InitForDevelopment/DWC_InitForProduction関数で行うよう仕様変更したため、関連する記述を修正

5.1pr2より前の変更履歴はこちら