Flutter自定义图标接口插件nothing_glyph_interface的使用

法律声明

我与Nothing没有任何关系，并且不拥有其任何物理或数字产品的权利。包含的jar文件是Nothing的财产。

注意事项

为了让此插件在真实的Nothing设备上正常工作，必须首先启用图标调试：

adb shell settings put global nt_glyph_interface_debug_enable 1

调试模式将在48小时后自动禁用以防止SDK被滥用。对于后续发布，请联系Nothing获取正确的API密钥，并将其添加到您的AndroidManifest.xml文件中。

<!-- 这个标签应该添加在application标签内 -->
<meta-data android:name="NothingKey" android:value="{Your APIKey}" />

使用方法

一般来说，该插件的实现方式与Glyph Developer Kit相同。

基本设置

创建一个NothingGlyphInterface实例：

NothingGlyphInterface _nothingGlyphInterface = NothingGlyphInterface();

检查Android设备是否为Nothing Phone 1, Phone 2, Phone 2a 或 Phone 2a Plus：

bool isPhone1 = await _nothingGlyphInterface.is20111();
bool isPhone2 = await _nothingGlyphInterface.is22111();
bool isPhone2a = await _nothingGlyphInterface.is23111();
bool isPhone2aPlus = await _nothingGlyphInterface.is23113();

监听Glyph连接流。插件应在应用启动时尝试连接到Glyph接口，并在应用结束时关闭连接。

_nothingGlyphInterface.onServiceConnection.listen((bool connected) {
  print("connected: $connected");
});

获取Glyph接口的当前状态：

int? period = await _glyphInterfacePlugin.getPeriod();
int? cycles = await _glyphInterfacePlugin.getCycles();
int? interval = await _glyphInterfacePlugin.getInterval();
List<int>? channel = await _glyphInterfacePlugin.getChannel();

触发Glyph接口

请使用提供的GlyphFrameBuilder来创建Glyph帧：

// 基本示例
await _glyphInterfacePlugin.buildGlyphFrame(GlyphFrameBuilder()
    .buildChannelA()
    .build()
);

// 更复杂的示例
await _glyphInterfacePlugin.buildGlyphFrame(GlyphFrameBuilder()
    .buildChannelA()
    .buildChannel(NothingPhone2.c3)
    .buildPeriod(2000)
    .buildCycles(3)
    .buildInterval(1000)
    .build()
);

创建Glyph帧后，必须触发它使接口点亮：

// 用于启用/禁用在GlyphFrame中设置的通道。
await _glyphInterfacePlugin.toggle();

// 用于使用在GlyphFrame中设置的通道、周期和间隔参数进行呼吸动画。
await _glyphInterfacePlugin.animate();

// 用于在C1/D1上显示进度值。
await _glyphInterfacePlugin.displayProgress();

// 用于同时在所有Glyphs上切换（除了C1/D1），并在C1/D1上显示进度值。
await _glyphInterfacePlugin.displayProgressAndToggle();

### 完整示例Demo

```dart
import 'package:flutter/material.dart';
import 'package:nothing_glyph_interface/nothing_glyph_interface.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late NothingGlyphInterface _glyphInterfacePlugin;

  [@override](/user/override)
  void initState() {
    _glyphInterfacePlugin = NothingGlyphInterface();
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              FutureBuilder(
                future: _glyphInterfacePlugin.is20111(),
                builder: (context, snapshot) {
                  if (snapshot.connectionState == ConnectionState.waiting) {
                    return const CircularProgressIndicator();
                  }

                  return Text('Is Nothing Phone 1: ${snapshot.data}', textAlign: TextAlign.center);
                },
              ),
              FutureBuilder(
                future: _glyphInterfacePlugin.is22111(),
                builder: (context, snapshot) {
                  if (snapshot.connectionState == ConnectionState.waiting) {
                    return const CircularProgressIndicator();
                  }

                  return Text('Is Nothing Phone 2: ${snapshot.data}', textAlign: TextAlign.center);
                },
              ),
              FutureBuilder(
                future: _glyphInterfacePlugin.is23111(),
                builder: (context, snapshot) {
                  if (snapshot.connectionState == ConnectionState.waiting) {
                    return const CircularProgressIndicator();
                  }

                  return Text('Is Nothing Phone 2a: ${snapshot.data}', textAlign: TextAlign.center);
                },
              ),
              FutureBuilder(
                future: _glyphInterfacePlugin.is23113(),
                builder: (context, snapshot) {
                  if (snapshot.connectionState == ConnectionState.waiting) {
                    return const CircularProgressIndicator();
                  }

                  return Text('Is Nothing Phone 2a Plus: ${snapshot.data}', textAlign: TextAlign.center);
                },
              ),
              const SizedBox(height: 30),
              ElevatedButton(
                onPressed: () async {
                  await _glyphInterfacePlugin.buildGlyphFrame(
                      GlyphFrameBuilder().buildChannelA().buildChannel(NothingPhone2.c3).buildPeriod(2000).buildCycles(3).buildInterval(1000).build());
                  await _glyphInterfacePlugin.animate();
                },
                child: const Text("测试"),
              ),
            ],
          ),
        ),
      ),
    );
  }
}