クラス _Main

アプリの雛型を提供します。アプリは必ずこのクラスを継承して作成しなければなりません。

インスタンスメソッド

setApplyScale:

- (void)setApplyScale:(BOOL)flag

高解像度モードのON/OFFを切り替えます。

パラメータ:
flag高解像度モードにする場合 YES、しない場合 NO

applyScale

- (BOOL)applyScale

高解像度モードのON/OFF状態を取得します。

戻り値:
高解像度モードになっている場合 YES、なっていない場合 NO

getWindow

- (UIWindow*)getWindow

UIWindow オブジェクトを取得します。

戻り値:
UIWindow オブジェクトを返します。

getViewController

- (UIViewController*)getViewController

UIViewController オブジェクトを取得します。

戻り値:
UIViewController オブジェクトを返します。

getOrientation

- (UIInterfaceOrientation)getOrientation

画面の向きを取得します。

戻り値:
画面の向きを返します。

UIInterfaceOrientationPortrait ホームボタン下
UIInterfaceOrientationLandscapeLeft ホームボタン左
UIInterfaceOrientationLandscapeRight ホームボタン右
UIInterfaceOrientationPortraitUpsideDown ホームボタン上

setCurrent:

- (void)setCurrent:(_CanvasCore*)canvas

カレントのキャンバスを設定します。

パラメータ:
canvas_Canvas/_Canvas3D クラスを継承したクラスオブジェクトを指定します。

getCurrent

- (_CanvasCore*)getCurrent

カレントのキャンバスを取得します。

戻り値:
カレントのキャンバスを返します。

setView:

- (void)setView:(UIView*)view

パラメータ:
view

補足説明:

getView

- (UIView*)getView

戻り値:

addCanvas:

- (void)addCanvas:(_Canvas*)canvas

パラメータ:
canvas_Canvas/_Canvas3D クラスを継承したクラスオブジェクトを指定します。

補足説明:

getParameter:
getParameter:defString:
getParameter:defInteger:

- (NSString*)getParameter:(NSString*)name
- (NSString*)getParameter:(NSString*)name defString:(NSString*)defString
- (int)getParameter:(NSString*)name defInteger:(int)defInteger

他のアプリから起動された場合のパラメータを取得します。

パラメータ:
name取得するパラメータの名前を指定します。
defStringデフォルトの文字列を指定します。
defIntegerデフォルトの整数値を指定します。

戻り値:
パラメータを表す文字列または整数値を返します。パラメータがない場合で、デフォルトの文字列または整数値が指定されていない場合、nil を返します。

resourceURL:

- (NSURL*)resourceURL:(NSString*)name

リソースファイルのURLを取得します。

パラメータ:
nameリソースファイル名

戻り値:
リソースファイルのURLを返します。指定されたリソースファイルが見つからない場合は nil を返します。

launch::

- (BOOL)launch:(NSString*)name :(NSArray*)args

他のアプリを起動します。

パラメータ:
name起動先アプリのカスタムURLスキームを指定します。
args起動先アプリに渡すパラメータの名前と値の組を順番に指定します。n 番目のパラメータの名前を n*2 番目の要素に、その値を n*2+1 番目の要素に指定します。

戻り値:
起動に成功すると YES を、失敗すると NO を返します。

openBrowser:

- (void)openBrowser:(NSString*)url

ブラウザを開きます。

パラメータ:
urlページURL

getUserAgentString

- (NSString*)getUserAgentString

ユーザーエージェントを取得します。

戻り値:
ユーザーエージェントを返します。

setUserAgentString:

- (void)setUserAgentString:(NSString*)ua

ユーザーエージェントを設定します。

パラメータ:
uaユーザーエージェント

_backgroundColor

- (UIColor*)_backgroundColor

本メソッドをオーバーライドして、背景色を返してください。

_orientation

- (int)_orientation

本メソッドをオーバーライドして、画面の向きを返してください。次のいずれかを返します。

ORIENTATION_NOSENSOR デフォルトの設定に任せる
ORIENTATION_LANDSCAPE 横固定
ORIENTATION_PORTRAIT 縦固定

_fullScreen

- (BOOL)_fullScreen

本メソッドをオーバーライドして、フルスクリーン表示にする場合は YES を返してください。

補足説明:
iOS 7 以降では、フルスクリーン表示にする場合は Info.plist で「View controller-based status bar appearance」キーを「NO」に設定する必要もあります。

_applyScale

- (BOOL)_applyScale

本メソッドをオーバーライドして、起動時に高解像度モードにするかどうかを返してください。

_start

- (void)_start

アプリケーションが起動したら呼ばれるメソッドです。

_destroy

- (void)_destroy

アプリケーションが終了するときに呼ばれるメソッドです。

_suspend

- (void)_suspend

アプリケーションがサスペンド状態になった直後に呼ばれるメソッドです。

_resume

- (void)_resume

アプリケーションがサスペンド状態から戻った直後に呼ばれるメソッドです。

_onOrientationChange:

- (void)_onOrientationChange:(UIInterfaceOrientation)orientation

画面の向きが変更されたときに呼ばれるメソッドです。

パラメータ:
orientation変更後の画面の向きが渡されます。

UIInterfaceOrientationPortrait ホームボタン下
UIInterfaceOrientationLandscapeLeft ホームボタン左
UIInterfaceOrientationLandscapeRight ホームボタン右
UIInterfaceOrientationPortraitUpsideDown ホームボタン上

_gameCenterAuthOK

- (void)_gameCenterAuthOK

Game Center の認証に成功したときに呼ばれるメソッドです。

_gameCenterAuthNG

- (void)_gameCenterAuthNG

Game Center の認証に失敗したときに呼ばれるメソッドです。

_gameCenterReportAchievementOK::

- (void)_gameCenterReportAchievementOK:(NSString*)identifier :(float)percent

Game Center への達成状況の報告に成功したときに呼ばれるメソッドです。

パラメータ:
identifier報告したアチーブメント識別子
percent報告した達成状況

_gameCenterReportAchievementNG::

- (void)_gameCenterReportAchievementNG:(NSString*)identifier :(float)percent

Game Center への達成状況の報告に失敗したときに呼ばれるメソッドです。

パラメータ:
identifier報告したアチーブメント識別子
percent報告した達成状況

_gameCenterCloseAchievementView

- (void)_gameCenterCloseAchievementView

標準アチーブメントビューが閉じられたときに呼ばれるメソッドです。

_gameCenterReportScoreOK::

- (void)_gameCenterReportScoreOK:(NSString*)category :(int64_t)score

Game Center へのスコアの報告に成功したときに呼ばれるメソッドです。

パラメータ:
category報告した Leaderboard 識別子
score報告したスコア

_gameCenterReportScoreNG::

- (void)_gameCenterReportScoreNG:(NSString*)category :(int64_t)score

Game Center へのスコアの報告に失敗したときに呼ばれるメソッドです。

パラメータ:
category報告した Leaderboard 識別子
score報告したスコア

_gameCenterCloseLeaderboardView

- (void)_gameCenterCloseLeaderboardView

標準 Leaderboard ビューが閉じられたときに呼ばれるメソッドです。

_onHttpResponse:

- (void)_onHttpResponse:(NSData*)data

通信成功したときに呼ばれるメソッドです。

パラメータ:
dataレスポンスデータとして、NSData オブジェクトが渡されます。

_onHttpError:

- (void)_onHttpError:(int)status

通信失敗したときに呼ばれるメソッドです。

パラメータ:
statusHTTPステータスコードが渡されます。

_inAppPurchaseInvalid:

- (void)_inAppPurchaseInvalid:(NSString*)identifier

_InAppPurchase クラスの purchase: メソッドに指定したプロダクトIDが無効なときに呼ばれるメソッドです。

パラメータ:
identifierプロダクトID

_inAppPurchasePurchaseOK::

- (void)_inAppPurchasePurchaseOK:(NSString*)identifier :(NSData*)receipt

購入処理に成功したときに呼ばれるメソッドです。

パラメータ:
identifierプロダクトID
receiptレシートデータが渡されます。

_inAppPurchasePurchaseNG:

- (void)_inAppPurchasePurchaseNG:(NSString*)identifier

購入処理に失敗したときに呼ばれるメソッドです。

パラメータ:
identifierプロダクトID

_inAppPurchaseRestoreOK:

- (void)_inAppPurchaseRestoreOK:(NSString*)identifier

リストア処理に成功したときに呼ばれるメソッドです。

パラメータ:
identifierプロダクトID

_inAppPurchaseRestoreNG

- (void)_inAppPurchaseRestoreNG

リストア処理に失敗したときに呼ばれるメソッドです。

_inAppPurchaseRestoreCompleted

- (void)_inAppPurchaseRestoreCompleted

全てのリストア処理が終了したときに呼ばれるメソッドです。

_inAppPurchaseCancelled:

- (void)_inAppPurchaseCancelled:(NSString*)identifier

購入処理またはリストア処理がキャンセルされたときに呼ばれるメソッドです。

パラメータ:
identifierプロダクトID

_musicComplete:

- (void)_musicComplete:(id)music

BGM再生が完了したら呼ばれるメソッドです。

パラメータ:
music再生が完了した _Music オブジェクトが渡されます。

_twitterAuthOK

- (void)_twitterAuthOK

Twitter の認証に成功したときに呼ばれるメソッドです。

_twitterAuthNG

- (void)_twitterAuthNG

Twitter の認証に失敗したときに呼ばれるメソッドです。

_twitterTweetOK

- (void)_twitterTweetOK

ツイートに成功したときに呼ばれるメソッドです。

_twitterTweetNG:

- (void)_twitterTweetNG:(int)status

ツイートに失敗したときに呼ばれるメソッドです。

パラメータ:
statusHTTPステータスコードが渡されます。

_twitterCloseTweetComposeView

- (void)_twitterCloseTweetComposeView

標準ツイートビューが閉じられたときに呼ばれるメソッドです。

_onWebViewShouldStartLoad:

- (BOOL)_onWebViewShouldStartLoad:(NSString*)url

新しいURLが指定されたときに呼ばれるメソッドです。
リクエストを中止する場合 YES を返してください。

パラメータ:
urlURLが渡されます。

補足説明:
_onWebViewShouldStartLoad: 内で
if( [url hasPrefix:@"native://"] )
{
    NSString* command = [url substringFromIndex:9];
    if( [command isEqualToString:@"command1"] )
    {
        // ネイティブ処理
    }
    return YES;
}
のように実装し、JavaScript側で
location.href = "native://command1";
と実行することで、JavaScriptからネイティブ処理を呼び出すことができます。

_onWebViewStartLoad:

- (void)_onWebViewStartLoad:(NSString*)url

ページ読み込み開始時に呼ばれるメソッドです。

パラメータ:
urlURLが渡されます。

_onWebViewFinishLoad:

- (void)_onWebViewFinishLoad:(id)webView

ページ読み込み完了時に呼ばれるメソッドです。

パラメータ:
webView_WebView オブジェクトが渡されます。

_onWebViewLoadError::

- (void)_onWebViewLoadError:(NSError*)error :(id)webView

ページ読み込みエラー時に呼ばれるメソッドです。

パラメータ:
errorNSError オブジェクトが渡されます。
webView_WebView オブジェクトが渡されます。