Flutter签名调用与数据分析插件clevertap_signedcall_flutter的使用

Flutter签名调用与数据分析插件clevertap_signedcall_flutter的使用

CleverTap Signed Call Flutter SDK

👋 简介

CleverTap的Signed Call Flutter SDK 提供了移动应用内的通话服务，如果设备具有互联网连接并且安装了Signed Call Flutter SDK，则可以实现通话功能。

更多关于Signed Call功能的信息，请参阅 Signed Call文档。

要开始使用，请在此处 注册。

🚀 安装与快速入门

1. 要将 CleverTap Signed Call Flutter SDK 添加到您的项目，请编辑项目的 pubspec.yaml 文件：

dependencies:
  clevertap_signedcall_plugin: 0.0.7

1. 运行 flutter pub get 来安装SDK。

2. 现在，可以在Dart代码中使用：

import 'package:clevertap_signedcall_flutter/plugin/clevertap_signedcall_flutter.dart';

📑 文档与示例

1. 查看我们的 技术文档 以了解如何将Signed Call集成到您的Flutter应用中。
2. 查看我们的 示例Flutter项目

🆕 更新日志

请参阅 Signed Call Flutter SDK更新日志。

❓ 问题

如果您有任何问题或疑虑，可以通过CleverTap仪表板联系CleverTap支持团队。

示例代码

以下是示例代码，位于 example/lib/main.dart。

import 'dart:async';

import 'package:clevertap_signedcall_flutter/models/call_event_result.dart';
import 'package:clevertap_signedcall_flutter/models/call_events.dart';
import 'package:clevertap_signedcall_flutter/models/call_state.dart';
import 'package:clevertap_signedcall_flutter/models/log_level.dart';
import 'package:clevertap_signedcall_flutter/models/missed_call_action_click_result.dart';
import 'package:clevertap_signedcall_flutter/plugin/clevertap_signedcall_flutter.dart';
import 'package:clevertap_signedcall_flutter_example/pages/dialler_page.dart';
import 'package:clevertap_signedcall_flutter_example/route_generator.dart';
import 'package:flutter/material.dart';

import 'Utils.dart';

[@pragma](/user/pragma)('vm:entry-point')
void backgroundCallEventHandler(CallEventResult result) async {
  debugPrint(
      "CleverTap:SignedCallFlutter: backgroundCallEventHandler called from headless task with payload1: $result");
  Utils.showToast("${result.callEvent} is called!" );

  getCallState().then((value) => {
    debugPrint(
        "CleverTap:SignedCallFlutter: CallState in killed state is: => $value")
  });
}

[@pragma](/user/pragma)('vm:entry-point')
void backgroundMissedCallActionClickedHandler(
    MissedCallActionClickResult result) async {
  debugPrint(
      "CleverTap:SignedCallFlutter: backgroundMissedCallActionClickedHandler called from headless task with payload: $result");
  Utils.showToast("${result.action.actionLabel} is clicked!" );
}

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  CleverTapSignedCallFlutter.shared
      .onBackgroundCallEvent(backgroundCallEventHandler);
  CleverTapSignedCallFlutter.shared.onBackgroundMissedCallActionClicked(
      backgroundMissedCallActionClickedHandler);
  runApp(const MyApp());
}

Future<SCCallState?> getCallState() async {
  SCCallState? callState =
  await CleverTapSignedCallFlutter.shared.getCallState();
  return callState;
}

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

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

class _MyAppState extends State<MyApp> {
  late StreamSubscription<CallEventResult>? _callEventSubscription;
  late StreamSubscription<MissedCallActionClickResult>?
      _missedCallActionClickEventSubscription;
  static const int _callMeterDurationInSeconds = 15;

  [@override](/user/override)
  void initState() {
    super.initState();

    // 启用Signed Call插件的详细调试
    CleverTapSignedCallFlutter.shared.setDebugLevel(LogLevel.verbose);
    setup();
  }

  void setup() {
    _startObservingCallEvents();
    _startObservingMissedCallActionClickEvent();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      onGenerateRoute: RouteGenerator.generateRoute,
    );
  }

  // 监听实时的通话事件流
  void _startObservingCallEvents() {
    _callEventSubscription =
        CleverTapSignedCallFlutter.shared.callEventListener.listen((result) {
      getCallState().then((value) => {
            debugPrint(
                "CleverTap:SignedCallFlutter: Current CallState is: => $value")
          });

      debugPrint(
          "CleverTap:SignedCallFlutter: received callEvent stream with ${result.toString()}");
      var callDetails = result.callDetails;
      var callId = callDetails.callId;
      var channel = callDetails.channel;

      Utils.showToast("${callId?.substring(0, 3)}, ${channel.toString()}, ${result.callEvent.toString()} is called!");
      if (result.callEvent == CallEvent.callInProgress) {
        //_startCallDurationMeterToEndCall();
      }
    });
  }

  // 监听未接来电操作点击事件
  void _startObservingMissedCallActionClickEvent() {
    _missedCallActionClickEventSubscription = CleverTapSignedCallFlutter
        .shared.missedCallActionClickListener
        .listen((result) {
      debugPrint(
          "CleverTap:SignedCallFlutter: received missedCallActionClickResult stream with ${result.toString()}");
      Utils.showToast("${result.action.actionLabel} is clicked!" );

      Navigator.pushNamed(context, DiallerPage.routeName);
    });
  }

  // 启动计时器并在计时器结束时挂断正在进行的通话
  void _startCallDurationMeterToEndCall() {
    Timer(const Duration(seconds: _callMeterDurationInSeconds), () {
      CleverTapSignedCallFlutter.shared.hangUpCall();
    });
  }

  [@override](/user/override)
  void dispose() {
    super.dispose();
    _callEventSubscription?.cancel();
    _missedCallActionClickEventSubscription?.cancel();
  }
}