feat(IBluetoothService): add IBluetoothService service

exclusion.dic

@@ -106,3 +106,4 @@ Validatable
 noselect
 Urls
 Pharmacode
+bluetooth

src/BootstrapBlazor.Server/BootstrapBlazor.Server.csproj

@@ -29,7 +29,6 @@
     <PackageReference Include="BootstrapBlazor.BaiduOcr" Version="8.2.0" />
     <PackageReference Include="BootstrapBlazor.BarCode" Version="8.2.0" />
     <PackageReference Include="BootstrapBlazor.BarcodeGenerator" Version="8.2.0" />
-    <PackageReference Include="BootstrapBlazor.Bluetooth" Version="8.0.2" />
     <PackageReference Include="BootstrapBlazor.BootstrapIcon" Version="8.0.3" />
     <PackageReference Include="BootstrapBlazor.BootstrapIcon.Extensions" Version="8.2.0" />
     <PackageReference Include="BootstrapBlazor.Chart" Version="8.4.0" />

src/BootstrapBlazor.Server/Components/Samples/Bluetooth.razor

@@ -3,74 +3,109 @@
 
 <h3>@Localizer["BluetoothTitle"]</h3>
 
-<PackageTips Name="BootstrapBlazor.Bluetooth" />
+<h4>@Localizer["BluetoothIntro"]</h4>
 
-<Tips class="mt-2">
-    <p>@((MarkupString)Localizer["Tips"].Value)</p>
+<p>@((MarkupString)Localizer["BluetoothDescription"].Value)</p>
+
+<Pre>[Inject, NotNull]
+private IBluetoothService? BluetoothService { get; set; }</Pre>
+
+<Tips>
+    <ul class="ul-demo">
+        <li>@((MarkupString)Localizer["BluetoothTipsLi1"].Value)</li>
+        <li>@((MarkupString)Localizer["BluetoothTipsLi2"].Value)</li>
+    </ul>
+    <div>@((MarkupString)Localizer["BluetoothTipsTitle"].Value)</div>
 </Tips>
 
 <DemoBlock Title="@Localizer["BaseUsageTitle"]"
            Introduction="@Localizer["BaseUsageIntro"]"
            Name="Normal">
-    @if (ShowUI)
-    {
-        <span>@Localizer["InnerUI"]</span>
+    <div class="row form-inline g-3">
+        <div class="col-12">
+            <Button Text="@Localizer["BluetoothRequestText"]" Icon="fa-brands fa-bluetooth" OnClick="RequestDevice"></Button>
+            <Button Text="@Localizer["BluetoothConnectText"]" Icon="fa-solid fa-circle-play" IsAsync="true" IsDisabled="@(_blueDevice is not {Connected: false})" IsKeepDisabled="true" OnClick="Connect" class="ms-3"></Button>
+            <Button Text="@Localizer["BluetoothDisconnectText"]" Icon="fa-solid fa-circle-stop" IsDisabled="@(_blueDevice is not {Connected: true})" OnClick="Disconnect" class="ms-3"></Button>
+        </div>
+        <div class="col-12">
+            <Display Value="@BluetoothDeviceName" ShowLabel="true" DisplayText="Device Name"></Display>
+        </div>
+        <div class="col-12">
+            <div class="d-flex align-items-center">
+                <Button Text="@Localizer["BluetoothGetBatteryText"]" Icon="fa-solid fa-battery-half" IsDisabled="@(_blueDevice is not { Connected: true })" OnClick="GetBatteryValue"></Button>
+                <label class="d-flex align-items-center"><progress value="@_batteryValue" max="100" class="ms-3"></progress><span class="ms-3">@_batteryValueString</span></label>
+            </div>
+        </div>
+    </div>
+</DemoBlock>
+
+<p class="code-label mt-3">1. 服务注入</p>
+
+<Pre>[Inject]
+[NotNull]
+private IBluetoothService? BluetoothService { get; set; }</Pre>
+
+<p class="code-label">2. 列出蓝牙设备</p>
+<p>调用 <code>BluetoothService</code> 实例方法 <code>RequestDevice</code> 即可，通过 <code>IsSupport</code> 进行浏览器是否支持蓝牙</p>
+
+<Pre>_serialPort = await BluetoothService.RequestDevice(["battery_service"]);
+if (BluetoothService.IsSupport == false)
+{
+    await ToastService.Error(Localizer["NotSupportBluetoothTitle"], Localizer["NotSupportBluetoothContent"]);
+}</Pre>
 
-        <Printer OnResult="OnResult" ShowUI="true" OnError="OnError" OnUpdateStatus="OnUpdateStatus" OnUpdateError="OnError" OnGetDevices="OnGetDevices" />
+<p class="code-label">3. 连接设备</p>
+<p>调用 <code>IBluetoothDevice</code> 实例方法 <code>Connect</code> 即可</p>
 
+<Pre>private async Task Connect()
+{
+    if (_blueDevice != null)
+    {
+        var ret = await _blueDevice.Connect();
+        if (ret == false && !string.IsNullOrEmpty(_blueDevice.ErrorMessage))
+        {
+            await ToastService.Error("Connect", _blueDevice.ErrorMessage);
+        }
     }
-    else
+}</Pre>
+
+<p class="code-label">4. 断开设备</p>
+
+<p>调用 <code>IBluetoothDevice</code> 实例方法 <code>Disconnect</code> 断开连接，请注意路由切换时，请调用其 <code>DisposeAsync</code> 方法释放资源</p>
+
+<Pre>private async Task Disconnect()
+{
+    if (_blueDevice != null)
     {
-        <p>@Localizer["BasicUsage"]</p>
-        <Printer @ref="printer" OnResult="OnResult" OnError="OnError" OnUpdateStatus="OnUpdateStatus" OnUpdateError="OnError" OnGetDevices="OnGetDevices" />
-        <div>
-            <button data-action="btnConnect" class="btn btn-outline-primary">@Localizer["ConnectButtonText"]</button>
-            <button data-action="btnDisconnect" class="btn btn-outline-danger">@Localizer["DisconnectButtonText"]</button>
-            <button data-action="tools" class="btn btn-outline-primary" @onclick="printer.Print">@Localizer["PrintButtonText"]</button>
-        </div>
+        var ret = await _blueDevice.Disconnect();
+        if (ret == false && !string.IsNullOrEmpty(_blueDevice.ErrorMessage))
+        {
+            await ToastService.Error("Disconnect", _blueDevice.ErrorMessage);
+        }
     }
-    <hr />
-<pre>@message</pre>
-<pre style="color:green">@statusMessage</pre>
-<pre style="color:red">@errorMessage</pre>
-    <p />
-    <button class="btn btn-link" @onclick="SwitchUI ">@Localizer["SwitchUI"]</button>
-</DemoBlock>
+}</Pre>
 
-<h4>@Localizer["BluetoothTitle"]</h4>
-
-<DemoBlock Title="@Localizer["BluetoothBatteryLevelTitle"]"
-           Introduction="@Localizer["BluetoothBatteryLevelIntro"]"
-           Name="BatteryLevel">
-    <button class="btn btn-outline-primary" @onclick="GetBatteryLevel ">@Localizer["GetBatteryLevelButtonText"]</button>
-    <BatteryLevel @ref="batteryLevel" OnUpdateValue="OnUpdateValue" OnUpdateStatus="OnUpdateStatus" OnUpdateError="OnError" />
-    <br />
-    <progress max="100" value="@value"> @value % </progress>
-    <pre>@message</pre>
-    <pre style="color:green">@statusMessage</pre>
-    <pre style="color:red">@errorMessage</pre>
-</DemoBlock>
+<p class="code-label">注意事项</p>
+<p>可以通过调用 <code>IBluetoothService</code> 实例方法 <code>GetAvailability</code> 方法后，判断其实例属性 <code>IsAvailable</code> 检查当前终端是否有蓝牙模块</p>
 
-<h4>@Localizer["BluetoothHeartRate"]</h4>
-
-<DemoBlock Title="@Localizer["BatteryLevelTitle"]"
-           Introduction="@Localizer["BatteryLevelIntro"]"
-           Name="HeartRate">
-    <button class="btn btn-outline-primary" @onclick="GetHeartrate ">@Localizer["GetHeartrateButtonText"]</button>
-    <button class="btn btn-outline-danger" @onclick="StopHeartrate ">@Localizer["StopHeartrateButtonText"]</button>
-    <Heartrate @ref="heartrate" OnUpdateValue="OnUpdateValue" OnUpdateStatus="OnUpdateStatus" OnUpdateError="OnError" />
-    <h3 style="color:red" data-action="heartrate"></h3>
-    <pre>@message</pre>
-    <pre style="color:green">@statusMessage</pre>
-    <pre style="color:red">@errorMessage</pre>
-</DemoBlock>
+<p><code>IBluetoothService</code> 实例属性 <code>IsSupport</code> 是表示当前浏览器是否支持蓝牙功能</p>
+
+<p><code>IBluetoothService</code> 与 <code>IBluetoothDevice</code> 所有实例方法均有返回值，可通过查看其实例属性 <code>ErrorMessage</code> 获得上一次执行的错误描述信息</p>
+
+<p><code>IBluetoothDevice</code> 实例方法 <code>ReadValue</code> 是通用方法，通过参数指定<code>Services</code> 与 <code>Characteristics</code></p>
 
-<AttributeTable Title="@Localizer["PrinterComponent"]" Items="@GetAttributes()" />
+<p>原生方法 <code>getDevices</code> 暂未封装，因为需要设置浏览器才能开启</p>
 
-<AttributeTable Title="@Localizer["BatteryLevelComponent"]" Items="@GetAttributesBatteryLevel()" />
+<p>可根据自己的业务需求自定义扩展方法，内置扩展方法列表如下：</p>
 
-<AttributeTable Title="@Localizer["HeartrateComponent"]" Items="@GetAttributesHeartrate()" />
+<ul class="ul-demo">
+    <li><code>GetBatteryValue</code> 读取电量方法</li>
+</ul>
 
-<AttributeTable Title="@Localizer["BluetoothDeviceClass"]" Items="@GetBluetoothDeviceAttributes()" />
+<p class="code-label">相关文档</p>
 
-<AttributeTable Title="@Localizer["PrinterOptionClass"]" Items="@GetPrinterOptionAttributes()" />
+<ul class="ul-demo">
+    <li>Service List：<a href="https://github.com/WebBluetoothCG/registries/blob/master/gatt_assigned_services.txt" target="_blank">[传送门]</a></li>
+    <li>Characteristics List：<a href="https://github.com/WebBluetoothCG/registries/blob/master/gatt_assigned_characteristics.txt" target="_blank">[传送门]</a></li>
+    <li>Descriptors List：<a href="https://github.com/WebBluetoothCG/registries/blob/master/gatt_assigned_descriptors.txt" target="_blank">[传送门]</a></li>
+</ul>