Flutter屏幕录制插件 plugin_screeb 的功能

plugin_screeb 是一个用于集成 Screeb 移动 SDK 到 Flutter 应用程序的插件，支持 Android 和 iOS 平台。Screeb SDK 主要用于收集用户反馈、进行用户行为分析和提供实时用户调查等功能。

安装方法

有关如何在你的应用程序中安装 Flutter SDK，请参阅 官方文档。

功能概述

以下是 plugin_screeb 插件的主要功能及其使用示例：

初始化 SDK

PluginScreeb.initSdk(
  "082b7590-1621-4f72-8030-731a98cd1448",
  "5c62c145-91f1-4abd-8aa2-63d7847db1e1",
  "flutter_plugin@screeb.app",
  <String, dynamic>{
    'isConnected': false,
    'age': 29,
    'product': 'iPhone 13',
    'email': 'flutter_plugin@screeb.app',
    'born': DateTime.now()
  },
  <String, dynamic>{
    "version": "1.0.0",
    "onReady": (dynamic data) {
      log("onReady");
      log(data.toString());
    },
  },
);

设置用户身份

void _setIdentity(String userId, Map<String, dynamic>? properties) {
  PluginScreeb.setIdentity(userId, properties);
  log("SetIdentity");
}

设置用户属性

void _visitorProperty(Map<String, dynamic>? properties) {
  PluginScreeb.setProperty(properties);
  log("SetIdentityProperties");
}

分配用户到组

void _sendAssignGroup(String? groupType, String groupName, Map<String, dynamic>? properties) {
  PluginScreeb.assignGroup(groupType, groupName, properties);
  log("AssignGroup");
}

取消分配用户从组

void _sendUnassignGroup(String? groupType, String groupName, Map<String, dynamic>? properties) {
  PluginScreeb.unassignGroup(groupType, groupName, properties);
  log("UnassignGroup");
}

发送跟踪事件

void _sendTrackingEvent(String eventId, Map<String, dynamic>? properties) {
  PluginScreeb.trackEvent(eventId, properties);
  log("TrackingEvent");
}

发送跟踪屏幕

void _sendTrackingScreen(String screen, Map<String, dynamic>? properties) {
  PluginScreeb.trackScreen(screen, properties);
  log("TrackingScreen");
}

开始调查

void _startSurvey(String surveyId, bool allowMultiple, Map<String, dynamic>? hooks) {
  PluginScreeb.startSurvey(surveyId, allowMultiple, null, true, hooks);
  log("StartSurvey");
}

关闭 SDK

void _closeSdk() {
  PluginScreeb.closeSdk();
  log("CloseSdk");
}

重置用户身份

void _resetIdentity() {
  PluginScreeb.resetIdentity();
  log("ResetIdentity");
}

调试模式

void _debug() {
  PluginScreeb.debug();
  log("debug");
}

void _debugTargeting() {
  PluginScreeb.debugTargeting();
  log("debugTargeting");
}

示例 Demo

以下是一个完整的示例 demo，展示了如何在 Flutter 应用中使用 plugin_screeb 插件：

import 'package:flutter/material.dart';
import 'package:plugin_screeb/plugin_screeb.dart';
import 'dart:developer';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();

    PluginScreeb.initSdk(
      "082b7590-1621-4f72-8030-731a98cd1448",
      "5c62c145-91f1-4abd-8aa2-63d7847db1e1",
      "flutter_plugin@screeb.app",
      <String, dynamic>{
        'isConnected': false,
        'age': 29,
        'product': 'iPhone 13',
        'email': 'flutter_plugin@screeb.app',
        'born': DateTime.now()
      },
      <String, dynamic>{
        "version": "1.0.0",
        "onReady": (dynamic data) {
          log("onReady");
          log(data.toString());
        },
      },
    );
  }

  // 其他方法定义...

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              const Text("Screeb Commands"),
              ElevatedButton(
                child: const Text('start survey'),
                onPressed: () => _startSurvey(
                  "1b1fe0c4-d41d-4307-9ca0-b0b66cce8cff",
                  true,
                  <String, dynamic>{
                    "version": "1.0.0",
                    "onSurveyShowed": (dynamic data) {
                      print("onSurveyShowed");
                      print(data.toString());
                    },
                    "onQuestionReplied": (dynamic data) {
                      print("onQuestionReplied");
                      print(data.toString());
                    },
                  },
                ),
              ),
              // 其他按钮定义...
            ],
          ),
        ),
      ),
    );
  }
}

通过上述代码示例，你可以了解如何使用 plugin_screeb 插件来初始化 SDK、设置用户身份、发送跟踪事件、开始调查等操作。