[JA] ウィジェット

Cafeウィジェット

Cafeウィジェットは、NAVER Cafe SDKを閉じると画面に自動表示されるウィジェットです。Cafeウィジェットを使えばゲームプレイ中にどこからでもCafeを利用することができます。

Cafeウィジェットは、NAVER Cafe SDK 1.6.0以上から対応。

Cafeウィジェット

Cafeウィジェットからスクリーンショットボタンをタップすると、ゲーム画面のスクリーンショットを撮ることができます。

スクリーンショットボタンをタップしたときに画面を撮る機能はncSDKWidgetPostArticleWithImageメソッドで実装します。

(void)ncSDKWidgetPostArticleWithImage;

ユーザーがCafeウィジェットからスクリーンショットボタンをタップしたらncSDKWidgetPostArticleWithImageメソッドを呼び出すようにデリゲートを登録した例です。

...
[[NCSDKManager getSharedInstance] setNcSDKDelegate:self];
...
- (void)ncSDKWidgetPostArticleWithImage {
    NSLog(@"スクリーンショットの要求");
}

Cafeウィジェットで動画録画ボタンをタップするとゲーム画面を録画できます。

useWidgetVideoRecord属性で動画録画機能の使用有無を設定します。

@property (nonatomic, assign) BOOL useWidgetVideoRecord;

useWidgetVideoRecord属性の値をYESに設定するとCafeウィジェットに動画録画ボタンが表示されます(基本値: NO)。

  /**
   * 動画録画機能の使用有無を決めます。
   */
[NCSDKManager getSharedInstance].useWidgetVideoRecord = YES;

動画の録画が完了したときに処理する作業はncSDKWidgetSuccessVideoRecordメソッドで実装します。

ncSDKWidgetSuccessVideoRecordメソッドはNAVER Cafe SDK 1.7.0から対応。

(void)ncSDKWidgetSuccessVideoRecord;

ユーザーがCafeウィジェットで動画録画ボタンをタップして動画の録画を終えたらncSDKWidgetSuccessVideoRecordメソッドを呼び出すようにデリゲートを登録した例です。

...
[[NCSDKManager getSharedInstance] setNcSDKDelegate:self];
...
- (void)ncSDKWidgetSuccessVideoRecord {
    NSLog(@"動画録画完了");
}

NAVER Cafe SDKを閉じるときにCafeウィジェットを表示するかどうかは、showWidgetWhenUnloadSDK属性で設定します。

@property (nonatomic, assign) BOOL showWidgetWhenUnloadSDK;

showWidgetWhenUnloadSDK属性の値をYESに設定するとNAVER Cafe SDKを閉じるときにCafeウィジェットが表示されます(基本値: YES)。 Cafeウィジェットを表示するように実装した例です。

  /**
   * NAVER Cafe SDKを閉じるときにCafeウィジェットを表示するかどうか決めます。
   */
[NCSDKManager getSharedInstance].showWidgetWhenUnloadSDK = YES;

Cafeウィジェットを実行するにはstartWidgetメソッドを使用します。

startWidgetメソッドは、NAVER Cafe SDK 1.7.0から対応。

(void)startWidget;

Cafeウィジェットの実行例を示します。

  /**
   * Cafeウィジェットを実行します。
   */
[[NCSDKManager getSharedInstance] startWidget];

Cafeウィジェットを閉じるにはstopWidgetメソッドを使用します。

stopWidgetメソッドは、NAVER Cafe SDK 1.7.0から対応。

(void)stopWidget;

Cafeウィジェットを強制的に閉じる例を示します。

  /**
   * Cafeウィジェットを閉じます。
   */
[[NCSDKManager getSharedInstance] stopWidget];