bilibili小游戏

使用小贴士

bl.openCustomerServiceConversation(Object object)

基础库 4.0.2 开始支持，低版本需做兼容处理。

以** [Promise 风格]调用**：支持

仅** [iOS] **支持

功能描述

bl.openCustomerServiceConversation是平台提供的小游戏客服能力，按钮界面由开发者绘制后。 进入客服会话。要求在用户发生过至少一次 touch 事件后才能调用。

语法

bl.openCustomerServiceConversation(options);

参数说明

options 类型为 object，属性如下：

属性类型默认值必填说明
sessionFromstring''否会话来源。该字段会透传给开发者在后台配置的客服链接（位于 query 中的 session_from 字段）。该字段最长不得超过 1000，超过将被截断。
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

回调成功

返回类型为 object，属性如下：

属性名类型说明最低版本
errMsgstring"openCustomerServiceConversation:ok"2.66.1

回调失败

返回类型为 object，属性如下：
属性名类型说明最低版本
errMsgstring"openCustomerServiceConversation:fail " + 详细错误信息2.66.1

示例代码

// 回调风格
bl.openCustomerServiceConversation({
  sessionFrom: "",
  success(res) {
    console.log(res);
  },
  fail(res) {
    console.log(res);
  },
});

// Promise风格
bl.openCustomerServiceConversation({
  sessionFrom: "",
}).then(res => {
  console.log(res);
}).catch(err => {
  console.log(res);
});

Tip

  • 要求在用户发生过至少一次 touch 事件后才能调用

客服系统流程介绍

  1. 小游戏管理后台配置客服关键词和对应的链接。
  2. 小游戏中调用该 API，引导玩家进入客服页
  3. 玩家在客服页发送小游戏开发者配置的关键词，客服页显示对应的回复内容或链接。
  4. 玩家点击该链接，跳转到小游戏开发者配置的页面。

详细流程如下：

← RewardedVideoAd.offError