Shortform API

    Shortform API


    기사 요약

    숏폼 설치하기

    https://pub.dev/packages/shoplive_player/install

    Depend on it

    Run this command:

    With Flutter:

     $ flutter pub add shoplive_player

    This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):

    dependencies:
      shoplive_player: ^1.6.5

    Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

    Import it

    Now in your Dart code, you can use:

    import 'package:shoplive_player/shoplive_player.dart';


    숏폼 실행하기

    void play({required ShopLiveShortformCollectionData data})를 통해 Shortform 상세화면을 재생합니다.

    • ShopLiveShortformCollectionData의 필드 값 중 하나 이상 넣으면 관련 상세화면을 재생할 수 있습니다.

    ShopLiveShortformCollectionData

    Property name

    Type

    Description

    shortsId

    String?

    숏폼 고유 ID

    shortsCollectionId

    String?

    숏폼 그룹 ID

    shortsSrn

    String?

    숏폼에 할당한 리소스를 관리하기 위한 Global resource name 입니다. 샵라이브 내부적으로 사용하는 값입니다.

    tags

    [String]?

    관련 Tag 검색을 할 수 있는 값

    tagSearchOperator

    ShopLiveTagSearchOperator?

    Tag 검색 옵션

    • OR : 통합 검색

    • AND : 교차 검색

    brands

    [String]?

    관련 Brand 검색을 할 수 있는 값 (제목, 식별자 모두 검색)

    shuffle

    Bool? // default = false

    무작위 재생할 수 있는 값 (Default: false)

    referrer

    String?

    경로를 추적할 수 있는 값

    isMuted

    Bool?

    숏폼 음소거 여부 (Default : false)

    delegate

    ShopLiveShortformReceiveHandlerDelegate?

    ShopLiveShortform의 각종 이벤트를 받아볼 수 있는 Delegate

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.play(data: data);


    숏폼 종료하기

    void close()를 통해 Shortform 상세화면을 종료합니다.

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.close();


    숏폼 상품 클릭 기능

    Stream<ShopLiveShortformProductData> onClickProduct를 통해 Shoplive Shortform에서 직접 상품 클릭 기능을 개발합니다. Create a product 가이드를 참고합니다.

    ShopLiveShortformProductData

    Property

    Type

    Description

    brand

    String?

    상품의 브랜드 정보

    currency

    String?

    상품의 통화

    description

    String?

    상품에 대한 설명

    discountPrice

    Double?

    상품의 할인 가격

    discountRate

    Double?

    상품의 할인율

    imageUrl

    String?

    상품 이미지 URL

    name

    String?

    상품명

    originalPrice

    Double?

    상품의 정상 가격

    productId

    Long?

    상품 고유의 아이디. 상품 등록 시 자동으로 발급

    showPrice

    Boolean

    상품의 보이는 가격

    sku

    String?

    상품 고유의 SKU 정보

    url

    String?

    상품 상세 페이지의 URL

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.onClickProduct.listen((data) {
      _showToast("onClickProduct : ${data.productId} ");
    });


    숏폼 배너 클릭 기능

    Stream<ShopliveShortformUrlData> onClickBanner를 통해 Shoplive Shortform에서 직접 배너 클릭 기능을 개발합니다. Create a banner 가이드를 참고합니다.

    ShopLiveShortformProductData

    Property

    Type

    Description

    brand

    String?

    상품의 브랜드 정보

    currency

    String?

    상품의 통화

    description

    String?

    상품에 대한 설명

    discountPrice

    Double?

    상품의 할인 가격

    discountRate

    Double?

    상품의 할인율

    imageUrl

    String?

    상품 이미지 URL

    name

    String?

    상품명

    originalPrice

    Double?

    상품의 정상 가격

    productId

    Long?

    상품 고유의 아이디. 상품 등록 시 자동으로 발급

    showPrice

    Boolean

    상품의 보이는 가격

    sku

    String?

    상품 고유의 SKU 정보

    url

    String?

    상품 상세 페이지의 URL

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.onClickBanner.listen((data) {
      _showToast("onClickBanner : ${data.url} ");
    });


    숏폼 공유하기 클릭 기능

    Stream<ShopLiveShortformShareData> onShare를 통해 Shoplive Shortform에서 직접공유하기 클릭 기능을 개발합니다.

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.onShare.listen((data) {
      _showToast("onClickShare : ${data.shortsId}, ${data.title}  ");
    });


    숏폼 시작 알림 기능

    Stream<ShopLiveBaseData> onStart를 통해 Shoplive Shortform이 시작 됐는지 알 수 있습니다.

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.onStart.listen((data) {
      _showToast("onShortformStarted");
    });


    숏폼 종료 알림 기능

    Stream<ShopLiveBaseData> onClose를 통해 Shoplive Shortform이 종료 됐는지 알 수 있습니다.

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.onClose.listen((data) {
      _showToast("onShortformClosed");
    });


    숏폼 로그 기능

    Stream<ShopliveShortformLogData> log를 통해 Shoplive Shortform이 로그를 확인할 수 있습니다.

    late final _shopLiveShortformPlugin = ShopLiveShortform();
    _shopLiveShortformPlugin.log.listen((data) {
      _showToast("onShortformEventLog : ${data.command}, ${data.payload} ");
    });