Flutter位置感知与行为分析插件sentiance_core的使用

Flutter位置感知与行为分析插件sentiance_core的使用

演示应用 #

https://github.com/sentiance/sample-apps-flutter

开始使用 #

要开始使用Sentiance Flutter插件，请查看快速入门指南。

原生SDK版本 #

此插件使用以下原生Sentiance SDK版本构建：

iOS: SENTSDK (6.10.1)
Android: com.sentiance.sdk (6.10.0)

支持的API #

以下是Sentiance Flutter插件当前支持的API列表：

List<Api> supportedApis = [
  Api(name: 'getVersion', description: '获取SDK版本'),
  Api(name: 'getUserId', description: '获取用户ID'),
  Api(name: 'getDiskQuotaLimit', description: '获取磁盘配额限制'),
  Api(name: 'reset', description: '重置SDK状态'),
  Api(name: 'createUser', description: '创建用户'),
  Api(name: 'userExists', description: '检查用户是否存在'),
  Api(name: 'requestAccessToken', description: '请求访问令牌'),
  Api(name: 'submitDetections', description: '提交检测结果'),
  Api(name: 'enableDetections', description: '启用检测功能'),
  Api(name: 'getSdkStatus', description: '获取SDK状态'),
  Api(name: 'enableDetectionsWithExpiryDate', description: '设置检测功能的过期日期'),
  Api(name: 'disableDetections', description: '禁用检测功能')
];

请注意，未来发布的版本将包含更多API。

完整示例Demo

以下是一个完整的示例代码，展示了如何在Flutter应用程序中使用sentiance_core插件。

1. 初始化Sentiance SDK

首先，在您的main.dart文件中初始化Sentiance SDK。确保您已经在项目中添加了sentiance_core依赖。

dependencies:
  sentiance_core: ^最新版本

然后在main.dart中初始化SDK：

import 'package:flutter/material.dart';
import 'package:sentiance_core/sentiance_core.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SentianceCore.initialize('your_api_key');
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

2. 创建用户

接下来，您可以创建一个用户并启用检测功能。

class HomePage extends StatefulWidget {
  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  String _userId = '';
  bool _isDetectionEnabled = false;

  @override
  void initState() {
    super.initState();
    _initializeUser();
  }

  Future<void> _initializeUser() async {
    try {
      final userId = await SentianceCore.createUser(CreateUserOptions());
      setState(() {
        _userId = userId;
      });
      _enableDetections();
    } catch (e) {
      print("Error initializing user: $e");
    }
  }

  Future<void> _enableDetections() async {
    try {
      await SentianceCore.enableDetections();
      setState(() {
        _isDetectionEnabled = true;
      });
    } catch (e) {
      print("Error enabling detections: $e");
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Sentiance Core Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('User ID: $_userId'),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: !_isDetectionEnabled ? _enableDetections : null,
              child: Text(_isDetectionEnabled ? '检测已启用' : '启用检测'),
            ),
          ],
        ),
      ),
    );
  }
}

3. 提交检测结果

您还可以提交检测结果以进行进一步分析。

Future<void> _submitDetections() async {
  try {
    // 假设您已经有了检测数据
    final detections = Detections(); 
    await SentianceCore.submitDetections(detections);
    print("Detections submitted successfully");
  } catch (e) {
    print("Error submitting detections: $e");
  }
}

4. 获取SDK状态

最后，您可以获取SDK的状态以了解其是否正常运行。

Future<void> _getSdkStatus() async {
  try {
    final status = await SentianceCore.getSdkStatus();
    print("SDK Status: $status");
  } catch (e) {
    print("Error getting SDK status: $e");
  }
}