Shoplive Android SDK

28002800

Shoplive Android SDK는 간단한 Java 또는 Kotlin 코드만 삽입하여 여러분의 앱을 사용하는 고객에게 쉽고 빠르게 라이브 방송을 제공할 수 있는 모바일 SDK입니다. Shoplive PIP(Picture-in-Picture), 네이티브 키보드 UI 등 스마트폰에서 원활한 모바일 경험을 가능하게 합니다.

350350

특징

  • Shoplive Player를 사용하여 Shoplive 방송을 재생할 수 있습니다.
  • 저화질/무음으로 설정한 Shoplive 방송을 영상 배너로 나타내어 사용자가 Shoplive 방송을 시청하도록 유도할 수 있습니다.
  • 사용자가 Shoplive 방송을 시청하면서 채팅에 참여하고 상품을 검색하도록 할 수 있습니다.
  • 게스트로 채팅에 참여하고, 채팅에 참여한 사용자 정보를 실시간 전달받을 수 있습니다.
  • 인증 사용자로 채팅에 참여하고, 간편 인증/보안 인증으로 사용자 계정을 연동할 수 있습니다.
  • 채팅 대화명 및 채팅 폰트를 변경할 수 있습니다.
  • 쿠폰을 사용할 수 있습니다.
  • 여러 기능을 사용하여 상품을 관리할 수 있습니다.
  • 기본 시스템 공유 UI를 사용하거나 커스텀 시스템 공유 UI를 사용할 수 있습니다.
  • 재생 중인 방송 링크를 공유할 수 있습니다.
  • Shoplive Player 재생 중 인터럽트 옵션을 설정할 수 있습니다.
  • 태블릿 세로 모드에서 영상 비율을 설정할 수 있습니다.
  • 재생 중인 방송에 관한 각종 정보를 실시간 전달받을 수 있습니다.
  • Shoplive Android SDK에 관한 각종 정보를 실시간 전달받을 수 있습니다.

요구 사양

Shoplive Android SDK를 사용하기 위한 최소 요구 사양입니다. 이 요구 사항을 충족하지 않으면 Shoplive Android SDK를 사용할 수 없습니다.

  • Android 4.4 이상
  • targetSdkVersion 30 이상

📘

ExoPlayer 버전을 확인하세요.

고객사 앱에서 사용하는 ExoPlayer 버전이 2.16.0 보다 낮아 오류가 발생하면 ExoPlayer를 2.16.0 버전으로 업데이트하는 것을 권장합니다.


변경 사항

v1.3.2 (2022-11-30)

  • PIP 전환 인터페이스(startPictureInPicture, stopPictureInPicture)를 동시에 여러 번 호출 하더라도 한 번만 동작하도록 개선하였습니다.
  • 공유 버튼을 클릭했을 때 설정한 URL이 없으면 onError Handler로 에러코드를 전달하도록 개선하였습니다.
  • 딥링크로 Shoplive Player를 실행한 후 PIP로 전환할 때 고객사 앱의 생명주기에 영향을 줄 수 있는 문제를 수정하였습니다.
  • 채팅 입력창이 더 자연스럽게 올라오도록 애니메이션을 적용하였습니다.
  • 채팅 입력창이 채팅을 가릴 수 있는 문제를 수정하였습니다.

v1.3.1 (2022-10-18)

  • 이제 방송 배경 이미지(방송 예고, 진행 중, 종료 후 이미지)에 애니메이션 이미지를 사용할 수 있습니다. (gif, apng, webp 등)

v1.3.0 (2022-09-22)

  • 가로모드 방송을 지원하도록 업데이트 되었습니다. 가로모드 방송을 사용하기 위해서는 Shoplive 담당자에게 문의해주시기 바랍니다.
  • 미리보기를 고객사에서 직접 구현할 수 있도록 ShopLivePreview(또는 ShopLiveSwipeView)를 제공합니다.
  • 사용자 정의 메시지를 적용할 수 있도록 setUiMessage 인터페이스가 추가 되었습니다.
  • 상태바 영역까지 영상을 확대(상태바를 투명하게) 할 수 있도록 setStatusBarTransparent 인터페이스가 추가 되었습니다.
  • 오디오 포커스를 핸들링 할 수 있도록 setSoundFocusHandling 인터페이스가 추가 되었습니다.
  • Shoplive Player의 이벤트 로그를 전달하는 log 인터페이스가 추가 되었습니다.
  • onChangedPlayerStatus callback에 "CLOSING" 이벤트가 추가 되었습니다.
  • 'android.permission.BLUETOOTH' 권한이 targetSDkVersion 30까지만 적용되도록 변경 되었습니다.

v1.2.7.1 (2022-07-01)

  • PIP의 상태를 체크하는 로직을 개선하였습니다.
  • 일부 디바이스에서 채팅 입력 버튼을 클릭할 경우 발생하는 UI 이슈를 개선하였습니다.

v1.2.7 (2022-05-26)

  • Shoplive player가 PIP 모드로 실행 중인 상태에서 사용자의 인증 정보가 업데이트 되면 (예, 비로그인 -> 로그인) player가 전체 화면 모드로 변경되는 이슈를 개선하였습니다. 인증 정보가 변경되더라도 PIP 모드를 그대로 유지할 수 있습니다.

이전 버전 업데이트 내역


SDK 샘플

아래 링크에서 SDK 샘플을 확인할 수 있습니다.

https://github.com/shoplive/android-sdk-sample