檢視器SDK命名空間

檢視器是由許多檢視器SDK元件所建置。 在大多數情況下,網頁不需要直接與SDK元件API互動;檢視器API本身會涵蓋所有常見需求。

不過,有些進階使用案例會要求網頁使用getComponent()檢視器API來取得內部SDK元件的參考,然後使用SDK本身API的所有彈性。

檢視器用來載入和初始化SDK元件的命名空間取決於檢視器運作的環境。 如果檢視器在AEM(Adobe Experience Manager)中執行,檢視器會將SDK元件載入至s7viewers.s7sdk命名空間。 而Dynamic Media Classic提供的檢視器會將SDK載入s7classic.s7sdk中。

無論是哪種情況,檢視器內的SDK所使用的命名空間會以s7viewerss7classic作為首碼。 此外,它與SDK使用指南或SDK API檔案中使用的純s7sdk命名空間不同。

因此,撰寫與內部檢視器元件通訊的自訂應用程式程式碼時,請務必使用完全限定的SDK命名空間。

例如,如果您打算監聽StatusEvent.NOTF_VIEW_READY事件,而檢視器是從Dynamic Media Classic提供,則完全限定的事件類型為s7classic.s7sdk.event.StatusEvent.NOTF_VIEW_READY,而事件接聽程式程式碼看起來類似下列:

<instance>.setHandlers({ 
 "initComplete":function() { 
  var pageView = <instance>.getComponent("pageView"); 
   pageView.addEventListener(s7classic.s7sdk.event.StatusEvent.NOTF_VIEW_READY, function(e) { 
   console.log("view ready"); 
  }, false); 
} 
});

本頁內容