OfferwallQuiz

NestAdsOfferwallQuiz

public class NestAdsOfferwallQuiz

Kotlin

package com.nestads.sdk.offerwall.model.quiz

퀴즈 기능을 관리하는 클래스입니다. 퀴즈 목록 조회, 클릭 이벤트 처리 등의 기능을 제공합니다.

---

Methods

public fun setQuizEventsListener(listener: OfferwallQuizEventsListener)

퀴즈 이벤트 리스너를 설정합니다.

매개변수	설명
listener	퀴즈 이벤트를 수신할 리스너

Example:

val quiz = NestAds.Offerwall.quiz()
quiz.setQuizEventsListener { quizEvent, score ->
    println("Quiz completed: ${quizEvent.title}, Score: $score")
}

---

public fun getQuizList(onSuccess: (OfferwallQuizResponse) -> Unit, onFailure: (OfferwallAdError) -> Unit)

퀴즈 목록을 서버에서 조회합니다.

매개변수	설명
onSuccess	성공 시 퀴즈 응답 데이터를 전달받는 콜백
onFailure	실패 시 에러 정보를 전달받는 콜백

Example:

val quiz = NestAds.Offerwall.quiz()
quiz.getQuizList(
    onSuccess = { response ->
        println("Title: ${response.titleText}")
        response.events.forEach { quizEvent ->
            println("Quiz: ${quizEvent.title}, Point: ${quizEvent.point}")
        }
    },
    onFailure = { error ->
        println("Error: ${error.message}")
    }
)

---

public fun clickQuiz(quizId: String)

특정 퀴즈를 클릭 처리합니다. SDK가 초기화되지 않은 경우 동작하지 않습니다.

매개변수	설명
quizId	클릭할 퀴즈의 ID

Example:

val quiz = NestAds.Offerwall.quiz()
quiz.clickQuiz("quiz_123")

---

Usage Example

// 퀴즈 인스턴스 생성
val quiz = NestAds.Offerwall.quiz()

// 이벤트 리스너 설정 (SAM 변환 사용)
quiz.setQuizEventsListener { quizEvent, score ->
    println("Quiz completed: ${quizEvent.title}")
    println("Score: $score points")

    if (quizEvent.completed == true) {
        println("This quiz was already completed")
    }
}

// 퀴즈 목록 조회
quiz.getQuizList(
    onSuccess = { response ->
        // 타이틀 표시
        titleTextView.text = response.titleText

        // 완료 이미지 표시
        response.completedImageUrl?.let { url ->
            Glide.with(context).load(url).into(completedImageView)
        }

        // 퀴즈 목록 표시
        quizAdapter.submitList(response.events)
    },
    onFailure = { error ->
        println("Failed to get quiz list: ${error.message}")
    }
)

// 퀴즈 클릭
quiz.clickQuiz("quiz_id")

---

OfferwallQuizEvent

public data class OfferwallQuizEvent

Kotlin

package com.nestads.sdk.offerwall.model.quiz

개별 퀴즈의 정보를 담는 데이터 클래스입니다.

---

Properties

프로퍼티	타입	설명
id	String	퀴즈 고유 ID
title	String	퀴즈 제목
description	String?	퀴즈 설명 (Optional)
imageUrl	String	퀴즈 이미지 URL
landingUrl	String	퀴즈 클릭 시 이동할 URL
point	String	퀴즈 보상 포인트
status	String?	퀴즈 상태 (Optional)
completed	Boolean?	퀴즈 완료 여부 (Optional)
impressionOrder	Int?	노출 순서 (Optional)
placementId	String?	배치 ID (Optional)

---

Usage Example

quiz.getQuizList(
    onSuccess = { response ->
        response.events.forEach { quizEvent ->
            println("ID: ${quizEvent.id}")
            println("Title: ${quizEvent.title}")
            println("Description: ${quizEvent.description ?: "No description"}")
            println("Point: ${quizEvent.point}")
            println("Completed: ${quizEvent.completed ?: false}")

            // 완료되지 않은 퀴즈만 표시
            if (quizEvent.completed != true) {
                showQuiz(quizEvent)
            }
        }
    },
    onFailure = { error ->
        println("Error: ${error.message}")
    }
)

---

OfferwallQuizResponse

public data class OfferwallQuizResponse

Kotlin

package com.nestads.sdk.offerwall.model.quiz

퀴즈 API 응답 데이터를 담는 클래스입니다. UI 구성에 필요한 텍스트와 이미지 URL을 포함합니다.

---

Properties

프로퍼티	타입	설명
success	Boolean?	응답 성공 여부
titleText	String?	제목 텍스트
completedImageUrl	String?	완료 시 표시할 이미지 URL
completedImageWidth	Int?	완료 이미지 너비 (px)
completedImageHeight	Int?	완료 이미지 높이 (px)
events	List<OfferwallQuizEvent>	퀴즈 목록 (기본값: emptyList())
message	String?	메시지

---

Usage Example

val quiz = NestAds.Offerwall.quiz()
quiz.getQuizList(
    onSuccess = { response ->
        // 성공 여부 확인
        if (response.success == true) {
            // 타이틀 설정
            titleTextView.text = response.titleText

            // 완료 이미지 설정 (크기 지정)
            response.completedImageUrl?.let { url ->
                val width = response.completedImageWidth ?: 100
                val height = response.completedImageHeight ?: 100

                Glide.with(context)
                    .load(url)
                    .override(width, height)
                    .into(completedImageView)
            }

            // 퀴즈 목록 표시
            quizAdapter.submitList(response.events)

            // 메시지 표시
            response.message?.let { message ->
                showMessage(message)
            }
        }
    },
    onFailure = { error ->
        println("Error: ${error.message}")
    }
)

---

OfferwallQuizEventsListener

public fun interface OfferwallQuizEventsListener

Kotlin

package com.nestads.sdk.offerwall.listener

퀴즈 이벤트를 수신하기 위한 함수형 인터페이스입니다. SAM(Single Abstract Method) 변환을 지원합니다.

---

Methods

fun onQuizCompleted(quizEvent: OfferwallQuizEvent, score: Int)

퀴즈가 완료되었을 때 호출됩니다.

매개변수	설명
quizEvent	완료된 퀴즈 정보
score	획득한 점수

---

Usage Example

Lambda 표현식 사용 (권장)

val quiz = NestAds.Offerwall.quiz()

quiz.setQuizEventsListener { quizEvent, score ->
    println("Quiz '${quizEvent.title}' completed with score: $score")

    // 점수에 따른 처리
    when {
        score >= 100 -> showPerfectScoreAnimation()
        score >= 50 -> showGoodJobMessage()
        else -> showTryAgainMessage()
    }
}

익명 클래스 사용

val quiz = NestAds.Offerwall.quiz()

quiz.setQuizEventsListener(object : OfferwallQuizEventsListener {
    override fun onQuizCompleted(quizEvent: OfferwallQuizEvent, score: Int) {
        println("Quiz '${quizEvent.title}' completed with score: $score")

        // UI 업데이트
        runOnUiThread {
            scoreTextView.text = "Score: $score"
            refreshQuizList()
        }
    }
})