Magic Window Javascript SDK.
您可以直接通过URL引用我们的JS SDK;您也可以使用npm/Bower安装魔窗的JS SDK;
通过URL引用:
http://magicwindow.cn/sdk/jssdk/mw-sdk.js
http://magicwindow.cn/sdk/jssdk/mw-sdk.min.js
使用npm安装:
npm install mw-sdk --save
使用Bower安装:
bower install mw-sdk --save
在您的页面底部,引用mw-sdk.js的script标签之后,加入以下SDK的初始化代码:
mwsdk.init({
'appkey' : 'XEJ7F76J61LHEWRI3Q9A6UN9BM4C****', // 从哪里获取appkey?魔窗后台 》应用设置 》应用管理 》(你关联的应用里面的appkey)
'appVersion' : '2.3',
'Version' : '2.3'
});
在您需要显示魔窗位(活动入口)的位置加入下方的标签,此标签默认的宽度和高度以您在魔窗后台上传的活动展示图片尺寸一致,最大宽度为100%,高度会根据最大宽度的比例缩放,当然,您可以使用CSS代码自定义显示样式。
<mw-block id="xxxx" class="mw-banner"></mw-block>
其中id的属性值请按此方法获取:
- 进入魔窗后台;
- 在魔窗左侧边栏中点击“应用配置” 》 “应用配置”;
- 在应用配置的界面内正确关联您的应用;
- 点击您关联的应用内的“编辑”链接,进入应用编辑页面;
- 在关联好的应用的“魔窗位配置”的标签页内会显示所有的魔窗位(如果没有则新建魔窗位);
- 找到您需要的魔窗位的"魔窗位key",填到此处即可;
从v2.0.3开始,支持您使用HTML和CSS样式自定义魔窗位模板,在初始化mwsdk时,可以为所有魔窗位设置统一的自定义模板,也支持为每一个魔窗位设置不同的模板.
- 为所有魔窗位自定义统一的渲染模板:
mwsdk.init({
'appkey' : 'XEJ7F76J61LHEWRI3Q9A6UN9BM4C****',
'template': '<div><h3>[ $title ]</h3><img src="[ $imgUrl ]" thumb-src="[ $thumbUrl ]"/></div>'
});
如果您需要使用动态模板,您可以通过制定一个JS函数作为魔窗位渲染模板,该函数会传入一个Map类型的参数,这个Map包含了投放在此魔窗位中的活动配置,此函数的返回结果就是动态魔窗位模板:
mwsdk.init({
'appkey' : 'XEJ7F76J61LHEWRI3Q9A6UN9BM4C****',
'template': function (banner) {
// return '<div><img src="[ $imgUrl ]"/></div>'
return '<div><img src="'+ banner.imgUrl +'"/></div>'
}
});
__banner__支持的属性:
- banner.title 类型: String; 活动标题
- banner.description 类型: String; 活动描述
- banner.imgUrl 类型: String; 活动图片
- banner.thumbUrl 类型: String; 活动缩略图
- banner.startTime 类型: Number; 活动开始时间戳
- banner.endTime 类型: Number; 活动结束时间戳
- 为不同的魔窗位自定义不同的渲染模板:
mwsdk.init({
'appkey' : 'XEJ7F76J61LHEWRI3Q9A6UN9BM4C****',
'template': {
'魔窗位KEY1': '<img src="[ $imgUrl ]"/>',
'魔窗位KEY2': function(banner) {
var dateTime = new Date(banner.endtime);
var localeTime = dateTime.getYear() + '年' + dateTime.getMonth() + '月' + dateTime.getDate() + '日';
return '<div><img src="[ $imgUrl ]"/><span>活动结束时间: '+ localTime +'</span></div>'
}
}
});
这是一个最基础的使用mwsdk的实例, mwsdk会渲染简单的魔窗位(就显示一张图片), 如果您需要显示更详细的活动信息,请参考: DEMO-2.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
<title>MWSDK Demo</title>
</head>
<body ng-app="starter">
<!-- 第一步: 设置魔窗位(您可以放在您页面中的任何位置), 其中的ID是魔窗位ID(在魔窗后台的应用设置中能找到) -->
<mw-block id="xxxx-1" class="mw-banner"></mw-block>
<mw-block id="xxxx-2" class="mw-banner"></mw-block>
<!-- 第二步: 引用mwsdk -->
<script src="http://magicwindow.cn/sdk/jssdk/mw-sdk.min.js"></script>
<!-- 第三步: 初始化SDK -->
<script>
mwsdk.init({
'appkey' : "appkey-xxxxxxxxxxxxx", // 从哪里获取appkey: 魔窗后台 》应用设置 》应用管理 》(你关联的应用里面的appkey)
'appVersion': '3.9'
});
</script>
</body>
</html>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no, width=device-width">
<title>MWSDK Demo</title>
</head>
<body ng-app="starter">
<!-- 第一步: 设置魔窗位(您可以放在您页面中的任何位置), 其中的ID是魔窗位ID(在魔窗后台的应用设置中能找到) -->
<mw-block id="xxxx-1" class="mw-banner"></mw-block>
<mw-block id="xxxx-2" class="mw-banner"></mw-block>
<!-- 第二步: 引用mwsdk -->
<script src="http://magicwindow.cn/sdk/jssdk/mw-sdk.min.js"></script>
<!-- 第三步: 初始化SDK -->
<script>
mwsdk.init({
'appkey' : "appkey-xxxxxxxxxxxxx", // 从哪里获取appkey: 魔窗后台 》应用设置 》应用管理 》(你关联的应用里面的appkey)
'appVersion': '3.9',
'template': {
'xxxx-1': '<img src="[ $imgUrl ]"/>', // 自定义模板1 (直接使用HTML自定义模板)
'xxxx-2': customTemplate // 自定义模板2 (使用JS函数动态生成模板)
}
});
/**
* 渲染一个有详细描述的魔窗位, 渲染时, MWSDK会将当前魔窗位的配置做为第一个参数传给此方法, 参数类型是一个Map;
*
* @param data {Object} 魔窗位配置数据
*
* @param data.title {String} 活动标题
* @param data.description {String} 活动描述
* @param data.imgUrl {String} 活动图片
* @param data.thumbUrl {String} 活动缩略图
* @param data.startTime {Number} 活动开始时间戳
* @param data.endTime {Number} 活动结束时间戳
*/
function customTemplate (data) {
return '<div>' +
' <h2 style="color: red;">使用自定义模板渲染的魔窗位:</h2>' +
' <img src="[ $imgUrl ]" thumb-src="[ $thumbUrl ]"/>' +
' <h3>魔窗位标题: [ $title ]</h3>' +
' <p>描述:[ $description ]</p>' +
' <time>活动开始时间:'+ customDateFormater(data.startTime) +'; 活动结束时间: '+ customDateFormater(data.startTime) +'</time>' +
'</div>';
}
/**
* 时间格式化方法
* @param timestamp
* @returns {string}
*/
function customDateFormater(timestamp) {
var date = new Date();
date.setTime(datestamp);
var weeks = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
var dateStr = date.getFullYear()+'年'+(date.getMonth()+1)+'月'+date.getDate() +'日';
var timeStr = [date.getHours(), date.getMinutes(), date.getSeconds()].join(':');
var weekStr = weeks[date.getDay()];
return [dateStr, timeStr, weekStr].join(' ');
}
</script>
</body>
</html>
如果您是Hybrid App,用户在其他渠道(比如微信、QQ、微博、短信、邮件中)看到从您App中分享出去的使其感兴趣的内容后,很有可能会下载并安装您的App, 那么如何使用户在App安装后第一次打开时仍然能回到他在其他渠道看到的内容呢?答案就是__mLink__, 关于如何使用mLink服务,可以参考我们的帮助文档:
- 开始使用mLink;
- 如何在__H5站点__中使用mLink短链接?
- 如何在__推送服务__中使用mLink短链接?
- 如何在__短信__中使用mLink短链接?
- mLink Javascript Api使用说明,(此文档用于在您分享到其他渠道的H5页面中集成mLink服务);
接下来在您的App中调用魔窗JSSDK的场景还原方法,调用时机建议在您App首页初始化完成时调用。
// 示例一:使用回调
mwsdk.router(
function onSuccess(path) {
console.log('mwsdk.router:'+ path);
if (path) {
document.location.hash = path;
}
},
function onError(err) {
cosole.log('没有匹配的用户访问记录');
}
);
// 示例二:使用Promise
mwsdk.router()
.then(
function resolve(path) {
console.log('mwsdk.router:'+ path);
if (path) {
document.location.hash = path;
}
},
function reject(err) {
cosole.log('没有匹配的用户访问记录');
}
);