接入指南 API 工具 其他

自定义 Loading

快游戏自定义 Loading 组件

使用该功能时,需要判断引擎是否兼容,可通过if(qg.createCustomizeLoading)进行判断

qg.createCustomizeLoading(Object object)

创建 CustomizeLoading 组件

参数

Object object

属性类型必填说明
backgroundString背景图片,可以为网络图片或本地图片
textString加载进度文本
textColorString文本的颜色。必须是 16 进制格式的颜色字符串,例如:‘#999999’。
loadingColorTopStringloading 进度条渐变色顶部颜色。必须是 16 进制格式的颜色字符串,默认无背景色,例如:‘#999999’。
loadingColorBottomStringloading 进度条渐变色底部颜色。必须是 16 进制格式的颜色字符串,默认无背景色,例如:‘#999999’。
loadingProgressNumber进度条的进度
flowNumber首屏所需资源大小,显示流量消耗提示,单位 Mb。若首屏所需资源超过 30Mb,则必须提供该值,否则可能审核不通过

返回值

CustomizeLoading 组件

方法

CustomizeLoading.update(Object object)

更新 CustomizeLoading 样式,传入参数与 createCustomizeLoading 一致

CustomizeLoading.getProgress(Object object)

获取 CustomizeLoading 组件的进度

参数

Object object

属性类型必填说明
successFunction成功回调
failFunction失败回调
object.success(Object res) 回调函数
属性类型说明
currentProgressNumber当前 loading 进度

CustomizeLoading.remove()

销毁 CustomizeLoading 组件

CustomizeLoading.resetLoading()

重置 CustomizeLoading 组件进度

示例

//使用该功能时,需判断引擎是否支持
//创建CustomizeLoading组件
if (qg.createCustomizeLoading) {
  var loading = qg.createCustomizeLoading({
    background: "xxx.jpg",
    text: "正在加载中...",
    textColor: "#ffffff",
    loadingColorTop: "#ffffff",
    loadingColorBottom: "#ffffff",
    loadingProgress: 0
  });
}

//根据实际场景进行更新进度(只能增加)、背景、文字以及文字颜色
//更新CustomizeLoading样式
loading.update({
  background: "/image/logo.png",
  text: "正在加载中...",
  textColor: "#ffffff",
  loadingColorTop: "#ffffff",
  loadingColorBottom: "#ffffff",
  loadingProgress: 90
});

//获取CustomizeLoading进度
loading.getProgress({
  success: function(data) {
    console.log(`handling success: ${data.currentProgress}`);
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`);
  }
});

//移除CustomizeLoading组件
loading.remove();

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容