#include <dwc.h>
BOOL DWC_NdInitAsync(DWCNdCallback callback,
const char *gamecd,
const char *passwd);| callback | ダウンロードライブラリが各種通知時に呼び出すコールバック関数へのポインタ。必ず指定して下さい。 |
| gamecd | ダウンロードサーバへのアクセス時に必要となる接続用ゲームコード(文字列)へのポインタ |
| passwd | ダウンロードサーバへのアクセス時に必要となるゲーム用パスワード(文字列)へのポインタ |
| TRUE | 成功。初期化処理終了時にコールバック関数が呼び出されます。 |
| FALSE | 失敗。DWC_GetLastErrorEx関数を使用してエラーの情報を取得してください |
ダウンロードライブラリの初期化処理を開始します。
初期化処理はバックグラウンドでHTTP通信を行いますので、処理中はメインスレッドよりも優先度の低いスレッドに十分な処理時間が渡るようにしてください。なお、ダウンロードサーバは、開発向けと製品向けの2種類が提供されますが、この切り替えはDWC_SetAuthServer関数による認証サーバの切り替えにあわせて行なわれます。
引数として指定するgamecdおよびpasswdに関しては、弊社へのダウンロードサーバの利用申請後に発行されます。
本関数を呼び出しでTRUEが返された後、処理を進めるためにDWC_NdProcess関数を毎ゲームフレーム程度の頻度で呼び出してください。
初期化完了は本関数の引数で指定したDWCNdCallback型のcallbackで知ることができます。
返り値にTRUEが返された時点からダウンロードライブラリは開始していますので、初期化の非同期処理中にエラーが発生した場合も、DWC_NdCleanupAsync関数を呼ぶ必要があります。
本APIは、内部でTWL-SDKWi-FiライブラリのNHTTPStartup関数を呼び出します。本APIを呼び出してからDWC_NdCleanupAsync関数により処理が完了するまでの前後で、重複してNHTTPを使用しないようにしてください。
ダウンロード速度に関して、デフォルトの受信ウィンドウサイズでは、大きなサイズのファイルをダウンロードする際、パフォーマンスが悪くなります。
DWC_SetRwinSize関数を使って、アプリ毎に適切な受信ウィンドウサイズを設定しておくようにして下さい。
DWCNdCallback
DWC_SetAuthServer
DWC_GetLastErrorEx
DWC_NdProcess
DWC_SetRwinSize
5.1pr2より前の変更履歴はこちら