@triarensplugins/drplugin
损伤报告插件
npm i --save @triarensplugins/drplugin

@triarensplugins/drplugin

概述

@triarensplugins/drplugin 插件专为与 NativeScript 配合使用而设计,可在您的移动应用中处理损伤报告功能。此插件支持 iOS 和 Android 平台,并针对每个平台有具体要求。

要求

在开始之前,请确保您的项目满足以下平台特定要求

  • iOS:最低版本 15.0。
  • Android:最低 SDK 版本 27。

安装

您可以使用以下命令轻松将 @triarensplugins/drplugin 插件添加到您的 NativeScript 项目

tns plugin add @triarensplugins/drplugin

iOS 权限

要在 iOS 上使用此插件,您需要在您的应用 info.plist 文件中包含以下权限

<key>NSCameraUsageDescription</key>
<string>enter your camera permission request text here</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>enter your photo library permission request text here</string>
<key>NSCalendarsUsageDescription</key>
<string>enter your calendar permission request text here</string>
<key>NSCalendarsWriteOnlyAccessUsageDescription</key>
<string>enter your calendar permission request text here (for iOS17)</string>

请确保将占位符文本替换为适用于您的应用的适当权限请求消息。

用法

在 XML 中

  1. 使用以下行将插件命名空间添加到您的 XML 文件
xmlns:ui="@triarensplugins/drplugin"
  1. 在您的 XML 布局中使用 <ui:DRView> 元素以集成损伤报告视图。
<ui:DRView baseUrl="PROVIDED_BASE_URL" mandatorId="PROVIDED_MANDATOR_ID" phoneNumber="PROVIDED_PHONE_NUMBER" />

以下是您应该为 <ui:DRView> 设置的属性

  • baseUrl:由 "B&O" 提供。
  • mandatorId:"B&O" 提供的特殊 ID 字符串。
  • phoneNumber:"B&O" 提供的热线电话号码。

示例 XML

<Page
navigatingTo="onNavigatingTo"
xmlns="http://schemas.nativescript.org/tns.xsd"
xmlns:ui="@triarensplugins/drplugin">

<ui:DRView baseUrl="PROVIDED_BASE_URL" mandatorId="PROVIDED_MANDATOR_ID" phoneNumber="PROVIDED_PHONE_NUMBER" />
</Page>

自定义

您可以将损伤报告视图的颜色更改为您应用的配色方案。可用的颜色名称如下

  • primaryColor
  • backgroundLight
  • backgroundDark
  • secondaryLight
  • secondaryDark
  • error
  • emergency
  • primaryTextLight
  • primaryTextDark
  • secondaryTextLight
  • secondaryTextDark
  • borderLight
  • borderDark

例如,要更改 primaryColorbackgroundLight

<ui:DRView baseUrl="PROVIDED_BASE_URL" mandatorId="PROVIDED_MANDATOR_ID" phoneNumber="PROVIDED_PHONE_NUMBER" 
primaryColor="#32a852"
backgroundLight="green"/>

应用示例

有关如何在 NativeScript 应用中使用此插件的示例,请参阅 示例应用

作者

© B&O Service AG

联系方式

[email protected]