- 인쇄
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 검색 옵션
|
brands | [String]? | 관련 Brand 검색을 할 수 있는 값 (제목, 식별자 모두 검색) |
shuffle | Bool? // default = false | 무작위 재생할 수 있는 값 (Default: |
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} ");
});