1.3.3 Web集成指南

优质

小牛编辑

133浏览

2023-12-01

方式一：直接引入

<script src="https://res.sharetrace.com/sharetrace.min.js"></script>
<script>
    // 请填入对应的 App Key
    ShareTrace.init('your_app_key');

    // 请在用户点击下载按钮时，触发此函数
    function download() {
        ShareTrace.download();
    }
</script>

方式二：在VUE中引入

在 public/index.html 添加依赖

<html>
<head>
    ...
    <script src="https://res.sharetrace.com/sharetrace.min.js"></script>
    ...
</head>
<body>
...
</body>
</html>

在下载页初始化

export default {
    ...
    created() {
        ...
        // 请填入对应的 App Key
        ShareTrace.init('SHARETRACE_APPKEY');
        ...
    },
    methods: {
        ...
        handleDownload() {
            // 请在用户点击下载按钮时，触发此函数
            ShareTrace.download();
        }
        ...
    }
}

接口补充说明

`ShareTrace.init` 有两种初始化方式。

一：精简配置

ShareTrace.init("SHARETRACE_APPKEY")

二：更多配置

【参数名】	【参数类型】	【是否必填】	【参数说明】
appkey	string	`必填`	应用的AppKey，可到控制台中查看
param	string	选填	分享参数，如果不填写，默认取url的参数（url `?` 后面的参数）
error	function(errMsg)	选填	监听初始化异常
success	function()	选填	监听初始化成功

例子：

    ShareTrace.init({
        appkey: "your_app_key", // 此值必填
        param: "myKey=myValue",
        success: function() {
            console.log("init success...")
        },
        error: function(msg) {
            console.log(msg)
        }
    });

`ShareTrace.preDownload` 自定义重定向

如果要自定义下载方式，自己根据设备环境进行下载链接的重定向，可以在进行重定向之前调用ShareTrace.preDownload，不要再调用ShareTrace.download方法，download方法内部会根据在控制台配置的安装方式自动进行重定向。