nativescript-iadvize

NativeScript 插件，用于将 iAdvize 聊天集成到 Android/iOS 应用中。

iAdvize SDK 的 NativeScript 插件

这是一个使用 iAdvize SDK（Android v2.0.0-beta1，iOS v2.0.0-beta1）显示 iAdvize 聊天对话的插件。

要求

• iOS 12.0 或更高版本，以及 Xcode 12.5
• 最低 Android 版本 API 19，以及 Kotlin 1.5.10
• NativeScript CLI 7.x
• iAdvize 账户

安装

从您的项目根目录运行以下命令

npm install nativescript-iadvize

激活

当用户登录到您的应用时，调用 activate 并使用您的凭据（我们的示例 home.component.ts）

IAdvize.activate(XXXX, 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'userId', () => {
  console.log('IAdvize conversation activated.');
});

聊天

要打开聊天窗口，请调用 presentChat()

IAdvize.presentChat();

可选函数

隐藏默认聊天按钮

要隐藏默认聊天按钮，请调用 hideDefaultChatButton()

IAdvize.hideDefaultChatButton();

UI 定制

要定制聊天窗口 UI，请调用 customize()

const configuration: ChatConfiguration = {
  automaticMessage: 'Any question? Say Hello to Smart and we will answer you as soon as possible! 😊',
  font: 'fontPath',
  incomingMessageAvatar: 'avatar-icon',
  mainColor: '#4103fc',
  navigationBarBackgroundColor: '#4103fc',
  navigationBarMainColor: '#ffffff',
  navigationBarTitle: 'Chat Title'
};
IAdvize.customize(configuration);

注销

为保护用户对话的机密性，请调用 logout()。

IAdvize.logout();

对话事件

要添加监听器以实时了解对话事件，请调用 registerConversationListener()。

IAdvize.registerConversationListener((url: string) => {
  console.log('Handle clicked url - ' + url);
  return false;
}, (hasOngoingConversation: boolean) => {
    console.log('Ongoing conversation status changed - ' + hasOngoingConversation);
});

推送通知

要了解当您的应用未运行时收到的聊天消息，请调用 registerPushToken()

IAdvize.registerPushToken('your-token', isProduction);

开发设置

为了便于开发和调试，请继续以下步骤

打开命令提示符/终端，导航到 src 文件夹并运行 npm run demo.ios 或 npm run demo.android 以运行演示。

现在修改您的插件。它将自动应用于演示项目。

清理插件和演示文件

有时您可能需要删除所有生成的文件夹以重新安装它们。运行 npm run clean 以删除这些文件夹，然后您可以运行 plugin.prepare 来安装新的依赖项。

有时您只需要删除演示的平台、node_modules 和 hooks 目录。运行 npm run demo.reset 来删除这些。