[한] 위젯

카페 위젯

카페 위젯은 네이버 카페 SDK를 닫으면 자동으로 화면에 나타나는 위젯이다. 카페 위젯으로 게임 내 어디서든 카페를 이용할 수 있다.

카페 위젯은 네이버 카페 SDK 1.6.0 이상부터 지원한다.

화면 캡처 버튼

카페 위젯의 화면 캡처 버튼을 누르면 게임 화면을 캡처할 수 있다.

화면 캡처 버튼을 눌렀을 때 화면을 캡처하는 기능은 setOnWidgetScreenshotClickListener() 메서드에 위젯 스크린숏 버튼 클릭 리스너(OnWidgetScreenshotClickListener)를 등록해 구현한다.

위젯 스크린숏 버튼 클릭 리스너는 네이버 카페 SDK 1.7.0 이상부터 지원한다.

public static void setOnWidgetScreenshotClickListener(Glink.OnWidgetScreenshotClickListener onWidgetScreenshotClickListener);

다음은 위젯 스크린숏 버튼 클릭 리스너를 구현한 예다.

  /**
   * 위젯 스크린숏 버튼 클릭 리스너 설정
   */
  Glink.setOnWidgetScreenshotClickListener(new Glink.OnWidgetScreenshotClickListener() {
      @Override public void onScreenshotClick() {
        //TODO 화면 캡처 및 네이버 카페 SDK 실행(아래는 sudo 코드)
        String uri = screenCapture();
        Glink.startImageWrite(getActivity(), "title", uri);
      }
    });

카페 위젯 표시

네이버 카페 SDK가 닫힐 때 카페 위젯을 표시할지는 showWidgetWhenUnloadSdk() 메서드로 설정한다.

public static void showWidgetWhenUnloadSdk(Activity activity, boolean show);

show 파라미터의 값을 true로 설정하면 네이버 카페 SDK가 닫힐 때 카페 위젯이 나타난다(기본값: true).

다음은 카페 위젯이 표시되도록 구현한 예다.

  /**
   * 네이버 카페 SDK가 닫힐 때 위젯을 표시할지 결정한다.
   */
  Glink.showWidgetWhenUnloadSdk(activity, true);

카페 위젯 실행

카페 위젯을 실행하려면 startWidget() 메서드를 사용한다.

startWidget() 메서드는 네이버 카페 SDK 1.7.0부터 지원한다.

public static void startWidget(Activity activity);

다음은 카페 위젯을 실행하는 예다.

/**
 * 카페 위젯을 실행한다.
 */
Glink.startWidget(activity);

카페 위젯 닫기

카페 위젯을 닫으려면 stopWidget() 메서드를 사용한다.

public static void stopWidget(Activity activity)

다음은 카페 위젯을 강제로 닫는 예다.

  /**
   * 카페 위젯을 닫는다.
   */
  Glink.stopWidget(activity);

setWidgetUse() 메서드
setWidgetUse() 메서드는 네이버 카페 SDK 1.7.0부터 삭제됐다.
public static void setWidgetUse(Activity activity, boolean use);