사용자가 미동의를 누르면 룰렛 기능을 실행할 수 없습니다.

만약 BuzzAd와 BuzzScreen 모두 연동한 상태에서, 한 쪽에서만 BuzzRoulette을 활성화하려면 버즈빌 담당자에게 문의하세요.

기존에 BuzzAd Android용 SDK에서 buzz-roulette 라이브러리를 연동한 적이 있다면, 마이그레이션 가이드를 참고하여 BuzzRoulette 2.2.+에서 2.7.+로 업데이트하세요.

// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }  // jitpack 추가
        maven { url 'https://artifact.bytedance.com/repository/pangle' } // Pangle ADN
    }
}

// 앱 모듈의 build.gradle
dependencies {
    implementation "com.buzzvil:buzzad-benefit:3.5.+"
    implementation "com.buzzvil:buzz-roulette:2.7.+"
}

// 앱 모듈의 build.gradle
dependencies {
    implementation 'com.buzzvil:buzzscreen:4.0.+'    
    implementation 'com.buzzvil:buzz-roulette:2.7.+'
}

// 앱 모듈의 build.gradle
dependencies {
    implementation "com.buzzvil:buzzad-benefit:3.5.+"
    implementation 'com.buzzvil:buzzscreen:4.0.+'    
    implementation 'com.buzzvil:buzz-roulette:2.7.+'
}

위의 dependency 추가 시 오류가 발생할 수 있습니다. 오류 내용을 확인하려면 아래의 오류 전문을 클릭하세요. 이는 gradle.properties에 android.enableJetifier=true 를 추가하여 해결할 수 있습니다.

• 룰렛 아이콘을 표시하거나 제거하려면 반드시 버즈빌의 서버 설정이 병행되어야 합니다.

• 버즈빌이 서버에서 BuzzRoulette을 비활성화한 앱에는 룰렛 아이콘이 표시되지 않습니다.

• 버즈빌 서버에서 변경된 설정이 적용되기까지 최대 6시간이 소요될 수 있습니다.

BuzzAd를 연동한 경우에 해당하는 내용입니다. BuzzScreen만 연동하는 경우에는 해당하지 않습니다.

public class YourFeedToolbarHolder extends DefaultFeedToolbarHolder {

    @Override
    public View getView(Activity activity, @NonNull final String unitId) {
        toolbar = new FeedToolbar(activity); // FeedToolbar에서 제공하는 기본 템플릿을 사용합니다.
        // ...생략 ...
        addRouletteMenuItemView(activity); // 룰렛 버튼을 이 함수를 통해 추가할 수 있습니다.
        return toolbar;
    }
    ...
}

class YourPopToolbarHolder extends DefaultPopToolbarHolder {
    @Override
    public View getView(Activity activity, @NonNull final String unitId) {
        toolbar = new PopToolbar(activity); // PopToolbar 에서 제공하는 기본 Template 사용
        // ...생략 ...
        addRouletteMenuItemView(activity); // 룰렛 버튼 추가
        // ...생략 ...
        return toolbar;
    }
    ...
}

BuzzScreen을 연동한 경우에 해당하는 내용입니다. BuzzAd만 연동하는 경우에는 해당하지 않습니다.

• bindRouletteButton에서 roulette launch에 실패하면 자동으로 RouletteButton의 visibility가 GONE으로 설정됩니다.

  • RouletteButton의 visibility가 GONE으로 변경돼도 문제 없도록 레이아웃을 작성하세요.

  • RouletteButton의 visibility를 직접 변경하면 안 됩니다.

• RouletteButton의 android:layout_width, android:layout_height는 코드 예제와 같이 모두 wrap_content 로 설정해야 합니다. 크기를 임의로 변경하는 경우, 룰렛 버튼의 레이아웃이나 정렬이 틀어질 수 있습니다.

<!-- activity_custom_locker.xml -->
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:slider="http://schemas.android.com/apk/res-auto"
    tools:context=".CustomLockerActivity">
    <!-- ... 생략 ...  -->
    <!-- 룰렛 버튼을 추가합니다. --> 
    <com.buzzvil.buzzscreen.sdk.roulette.view.RouletteButton
                android:id="@+id/rouletteButton"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content" />
</layout>    

// CustomLockerActivity.java
public class CustomLockerActivity extends BaseLockerActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_custom_locker);
    
    RouletteButton rouletteButton = findViewById(R.id.rouletteButton);
    // 룰렛이 정상적으로 초기화되었는지 확인할 수 있는 이벤트 리스너
    RouletteLaunchListener rouletteLaunchListener = new RouletteLaunchListener() {
      @Override
      public void onSuccess() {
        // 룰렛이 정상적으로 초기화 되었을때 호출됩니다. 
      } 
      @Override
      public void onFailure() {
        // 룰렛 초기화가 실패되었을 때 호출됩니다. 
      }
    };
    
    룰렛 버튼을 클릭했을 때 룰렛이 정상적으로 시작되었는지 확인할 수 있는 이벤트 리스너
    RouletteStartListener rouletteStartListener = new RouletteStartListener() {
      @Override 
      public void onSuccess() {
        // 룰렛이 정상적으로 시작되었을 때 호출됩니다. 
        // TODO: 유저가 룰렛에 진입했다는 이벤트 기록 수집하는 등 기획에 따라 구현합니다. 
      }
  
      @Override
      public void onFailure() {
        // 룰렛 시작에 실패 했을 때 호출됩니다.
        // TODO: 룰렛 실패라는 이벤트 기록 수집하는 등 기획에 따라 구현합니다.
      }
    }
        
    bindRouletteButton(rouletteButton, rouletteLaunchListener, rouletteStartListener);
    // RouletteLaunchListener, RouletteStartListener 는 optional이므로 사용하지 않을 경우 null로 전달합니다. 
    // bindRouletteButton(rouletteButton, null, null);
  }
}

사용자는 룰렛 화면 우측 상단의 메뉴 아이콘을 통해 티켓박스 푸시 알림을 끌 수 있습니다.