1) 유저 식별 값 설정
|
파라메터 명칭 | 내용 |
context | 현재 Activity 또는 Context 객체 |
userName | 앱에서 사용자를 식별하기 위하여 사용하는 고유 ID 값 (로그인 ID 등) 길이는 256 bytes 이하입니다. |
2) 광고목록 띄우기 (Activity)
자신의 앱에서 광고 목록을 띄우기 위하여 TnkSession.showAdList() 함수를 사용합니다. 광고목록을 보여주기 위하여 새로운 Activity를 띄웁니다.Method
- void TnkSession.showAdList(Activity activity)
- void TnkSession.showAdList(Activity activity, String title)
- void TnkSession.showAdList(Activity activity, String title, TnkLayout userLayout)
Description
광고 목록 화면 (AdWallActivity)를 화면에 띄웁니다.
반드시 Main UI Thread 상에서 호출하여야 합니다.
Parameters
파라메터 명칭 | 내용 |
context | 현재 Activity 객체 |
title | 광고 리스트의 타이틀을 지정함 (기본값 : 무료 포인트 받기) |
userLayout | 원하는 Layout을 지정할 수 있습니다. 자세한 내용은 [라. 디자인 변경하기] 내용을 참고해주세요. |
적용 예시
3) 광고목록 띄우기 (View)
광고 목록을 현재 화면에 팝업으로 띄우기 위하여 TnkSession.popupAdList() 함수를 사용합니다. 광고목록을 보여주기 위하여 AdListView를 생성하여 현재 화면에 팝업형태로 띄워줍니다.Method
- void TnkSession.popupAdList(Activity activity)
- void TnkSession.popupAdList(Activity activity, String title)
- void TnkSession.popupAdList(Activity activity, String title, TnkAdListener listener)
- void TnkSession.popupAdList(Activity activity, String title, TnkAdListener listener, TnkLayout userLayout)
Description
광고 목록 화면 (AdListView)를 현재 화면에 팝업형태로 띄웁니다.
반드시 Main UI Thread 상에서 호출하여야 합니다.
Parameters
파라메터 명칭 | 내용 |
activity | 현재 Activity 객체 |
title | 광고 리스트의 타이틀을 지정함 (기본값 : 무료 포인트 받기) |
listnener | TnkAdListener 객체. 자세한 내용은 아래 [Listener 이용하기] 내용을 참고해주세요. |
userLayout | 원하는 Layout을 지정할 수 있습니다. 자세한 내용은 [라. 디자인 변경하기] 내용을 참고해주세요. |
적용 예시
4) AdListView
AdListView는 보상형 광고목록을 제공하는 View 객체입니다. 개발자는 createAdListView() 메소드를 사용하여 AdListView 객체를 생성할 수 있습니다.
생성된 AdListView 객체를 현재 Activity에 팝업형태로 띄우거나 자신의 구성한 화면의 하위 View로 추가(addView) 할 수 있습니다.
- AdListView 생성하기
Method
- AdListView TnkSession.createAdListView(Activity activity, boolean popupStyle)
- AdListView TnkSession.createAdListView(Activity activity, TnkLayout userLayout)
Parameters
파라메터 명칭 | 내용 |
context | 현재 Activity 객체 |
popupStyle | 생성되는 AdListView 화면을 팝업 화면 형태(true) 또는 전체 화면 형태(false)로 지정합니다. |
userLayout | 원하는 Layout을 지정할 수 있습니다. 자세한 내용은 [라. 디자인 변경하기] 내용을 참고해주세요. |
아래의 메소드들은 AdListView에서 제공하는 기능들입니다.
- void loadAdList()
- 광고목록을 서버에서 가져와 화면에 뿌려줍니다.
- 주로 AdListView를 하위 View로 추가하는 경우에 사용합니다.
- void show(Activity activity)
- AdListView를 현재 Activity의 최상위 View로 팝업형태로 띄워줍니다.
- 내부적으로는 activity의 addContentView() 를 사용합니다.
- 화면에 나타날때에 Animation 효과가 적용됩니다. 아래의 setAnimationType() 메소드를 참고하세요.
- 화면에 나타난 후에는 내부적으로 loadAdList()가 호출되어 바로 광고목록이 나타납니다.
- void setTitle(String title)
- 광고목록 상단 타이틀을 설정합니다.
- void setListener(TnkAdListener listener)
- AdListView 팝업 화면이 나타날때와 사라질때의 event를 받기 위하여 TnkAdListener 객체를 설정합니다.
- show() 메소드를 사용할 때에만 적용됩니다.
- 자세한 내용은 하단의 TnkAdListener 내용을 참고해주세요.
- void setAnimationType(int showType, int hideType)
- AdListView를 화면에 팝업으로 띄울 때 사용하는 애니메이션을 지정합니다.
- 나타날 때(showType)와 사라질 때(hideType)을 별도로 지정합니다.
- show() 메소드를 사용할 때에만 적용됩니다.
- 사용가능한 Animation의 종류들은 아래와 같습니다.
값 | 나타날때 | 사라질때 |
TnkSession.ANIMATION_RANDOM | 임의의 애니메이션이 적용됩니다. | 임의의 애니메이션이 적용됩니다. |
TnkSession.ANIMATION_NONE | 애니메이션이 적용되지 않습니다. | 애니메이션이 적용되지 않습니다. |
TnkSession.ANIMATION_ALPHA | 서서히 화면에 나타납니다. | 서서히 화면에서 사라집니다. |
TnkSession.ANIMATION_BOTTOM | 아래에서 위로 슬라이드되어 나타납니다. | 아래로 슬라이드되어 사라집니다. |
TnkSession.ANIMATION_TOP | 화면 위에서 아래로 슬라이드되어 나타납니다. | 화면 위로 슬라이드되어 사라집니다. |
TnkSession.ANIMATION_LEFT | 화면 왼쪽에서 슬라이드되어 나타납니다. | 화면 왼쪽으로 슬라이드되어 사라집니다. |
TnkSession.ANIMATION_RIGHT | 화면 오른쪽에서 슬라이드되어 나타납니다. | 화면 오른쪽으로 슬라이드되어 사라집니다. |
TnkSession.ANIMATION_SPIN | 화면 중앙에서 빙빙돌면서 커지면서 나타납니다. | 화면 중앙에서 빙빙돌면서 작아지면서 사라집니다. |
TnkSession.ANIMATION_FLIP | 화면 왼쪽에서부터 뒤집히는 방식으로 나타납니다. | 화면 오른쪽으로 뒤집히면서 사라집니다. |
사용 예시
AdListView를 팝업화면으로 화면에 띄울 경우 화면이 나타나는 시점과 화면이 닫히는 시점을 알고 싶을 때 아래의 TnkAdListener 인터페이스를 사용합니다.
TnkAdListener는 원래 전면 광고(Interstitial Ad 참고)에서 사용되지만 광고 리스트 화면에서도 화면이 팝업형태로 나타날 때 (onShow)와 닫힐 때(onClose)의 이벤트를 받기 위하여 사용될 수 있습니다.
AdListView와 관련되어 TnkAdListener에서 발생하는 이벤트의 내용은 아래와 같습니다.
- onClose(int type) : 팝업 화면이 닫히는 시점에 호출됩니다. 화면이 닫히는 이유가 type 파라메터로 전달됩니다.
- CLOSE_SIMPLE (0) : 사용자가 전면 화면의 닫기 버튼이나 Back 키를 눌러서 닫은 경우입니다.
- CLOSE_CLICK (1) : 사용자가 전면 화면의 광고를 클릭하여 해당 광고로 이동하는 경우 입니다.
- onShow() : 팝업화면이 나타날 때 호출됩니다.
- AdListView에서는 위 2가지 이외의 이벤트는 발생하지 않습니다.