모달 플레이어 단독 실행

숏폼을 전체 화면으로 재생하는 showShortformPlayerModal()을 통해 숏폼 피드를 바로 재생할 수 있습니다.

showShortformPlayerModal()로 플레이어 즉시 실행 시에는 음소거 상태로 자동 재생됩니다.

showShortformPlayerModal()를 사용하여 페이지가 로드될 때 즉시 실행되도록 구성할 경우, 자동 재생 정책을 준수하기 위해 음소거 모드로 재생됩니다. 동일 페이지 내의 사용자 클릭(User Gesture)을 통해 실행하는 경우에는 muted 파라미터를 통해 사운드 재생 상태로 시작할 수 있습니다.

피드 구성: 기본

기본적인 노출 순서에 따라 숏폼 피드를 노출합니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal();
</script>

숏폼의 콘텐츠마다 설정된 ‘태그’로 구성한 피드를 재생합니다.

단일 태그

단일 태그를 사용하여 피드를 구성할 수 있습니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal( { 
    tags: ["YOUR_TAG"] 
  });
</script>

복수 태그

복수의 태그들이 포함된 피드를 구성할 수 있습니다. 태그는 최대 5개까지 설정할 수 있으며 OR 조건으로 작동합니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal( { 
    tags: ["YOUR_TAG1", "YOUR_TAG2"] 
  });
</script>

tagSearchOperator="AND"를 사용하여 특정 태그를 모두 포함하는(AND 조건) 피드를 구성할 수 있습니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal({ 
    tags: ["YOUR_TAG1", "YOUR_TAG2"],
    tagSearchOperator: "AND"
  });
</script>

숏폼의 콘텐츠마다 설정된 ‘브랜드’로 구성한 피드를 재생합니다.

단일 브랜드

단일 ‘브랜드 식별자’를 사용하여 피드를 구성할 수 있습니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal( { 
    brands: ["brand_idetifier"] 
  });
</script>

복수 브랜드

복수의 브랜드가 포함한 피드를 구성할 수 있습니다. 브랜드 식별자는 최대 5개까지 설정할 수 있으며 OR 조건으로 작동합니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal( { 
    brands: ["brand_idetifier1", "brand_idetifier2"] 
  });
</script>

기본 셔플

피드 내 숏폼이 무작위로 재생되도록 구성할 수 있습니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal( { 
    shuffle: true 
  });
</script>

셔플: 태그, 브랜드

태그 또는 브랜드별 목록 구성과 함께 사용할 수 있습니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal( { 
    brands: ["brand_idetifier1"],
    tags: ["your_tag1"],
    shuffle: true
  });
</script>

피드 구성: Group ID & Shortform ID

숏폼 그룹의 ID와 그룹 내 숏폼의 ID를 사용하여 숏폼 피드를 재생합니다.

<script defer>
  cloud.shoplive.showShortformPlayerModal( { 
    shortformCollectionId: 'SHORTFORM_GROUP_ID'
    shortsId: 'SHORTS_ID'
  });
</script>

피드 구성: 특정 Shortform ID

숏폼 API 등을 통해 미리 정의한 id의 리스트를 사용하여 숏폼 피드를 재생합니다.

<script defer>
  // Configure a playlist using Shortform IDs.
  var ids = ["ID1", "ID2", "ID3", "ID4", "ID5"];
  // Set the startIndex at which playback will start.
  var startIndex = 0;
  cloud.shoplive.showShortformPlayerModal({ ids: ids, startIndex: startIndex });
</script>

재생 옵션

음소거 해제

동일 웹페이지에서 사용자 동작(예: click)에 의해 showShortformPlayerModal() 을 실행하는 경우, muted:false 옵션을 사용하여 사운드 재생 상태로 플레이어를 실행할 수 있습니다.

<script>
//playShortform function is executed by the user's click.
function playShortform() {
  cloud.shoplive.showShortformPlayerModal( { 
    muted:false
  });
}
</script>

숏폼이 설치된 동일 웹 페이지에서 사용자의 클릭 없이 muted:false 를 적용하여 바로 플레이어를 호출할 경우 재생이 실패합니다