查看器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); 
} 
});

在此页面上