# web集成

# 引入Javascript

以下为LinkDeep集成代码，建议在html文档中尽量靠前放置，加快初始化过程。

强烈建议直接引用下面的cdn加速链接，以得到最及时的更新，我们将持续跟踪各种主流浏览器的变化，提供最好的服务；不推荐将此js文件下载到自己的服务器。

<script type="text/javascript" charset="UTF-8" src="//res.ccsdyjx.com/static-res/jssdk/release/link-deep.min.js"></script>

# 配置Linkdeep

LinkDeep初始化时将与LinkDeep服务器交互，应尽可能早的调用。

# 初始化

new LinkDeep(options)

options是您要配置的一些内容，参数如下：

• appKey：LinkDeep平台为每个应用分配的ID，必填
• channelCode: 渠道code，选填，如果不填，我们会尝试通过url的search来获取该字段
• onReady: 回调函数，在前端跟后台进行交互完成之后调用，函数返回了“唤醒或者安装”wakeupOrInstall、唤醒wakeup、安装install三个方法

# 例子

new LinkDeep({
	appKey : "f3ny7s",
	channelCode: "sfy8117h7s3",
	onReady : function(wakeupOrInstall, wakeup, install) {
	  var button = document.getElementById("downloadButton");

	  button.style.display = "block";

	  /*在app已安装的情况尝试拉起app*/
	  wakeup();

	  /*用户点击某个按钮时(假定按钮id为downloadButton)，安装app*/
	  button.onclick = function() {
	    wakeupOrInstall();
	  }
	}
});

如果您的url上面已经携带channelCode，如：http://link-depp.com?channelCode= sfy8117h7s3，就可以不填该参数.

强烈建议：

• 不要在回调里面直接使用wakeupOrInstall以及install，因为浏览器安全机制机制问题，直接调用的下载可能会被浏览器阻拦，所以请务必把这两个方法放到按钮的点击事件里面调用。
• 在onReady回调触发之前，尽量隐藏或者置灰绑定事件的按钮，不然会出现用户点击按钮没有任何反应的情况，影响用户体验。
• 不要使用touchstart事件，请改用click。因为因为touchstart语义上来说不是一个用户主观意思的点击行为，有可能只是滑动页面，click是用户主观的点击行为，这样在一些浏览器里面会有更好的兼容性。