Flutter插件loplat_plengi的使用

Flutter插件loplat_plengi的使用

1. 配置依赖项

首先，在pubspec.yaml文件中添加loplat_plengi插件的依赖项：

dependencies:
  flutter:
    sdk: flutter

  loplat_plengi: ^[plugin_version]

2. Android 配置

在Android项目中，修改build.gradle文件以包含必要的依赖项和库：

allprojects {
  repositories {
    jcenter()
    mavenCentral()
    maven { url "https://maven.loplat.com/artifactory/plengi"}
    google()
  }
}

// 在应用级别的 build.gradle 文件中
dependencies {
  implementation 'com.loplat:placeengine:2.1.2.1'
  implementation 'com.google.android.gms:play-services-location:21.0.1'
  implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
  implementation 'com.squareup.retrofit2:retrofit:2.9.0'
  implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
  implementation 'com.squareup.okhttp3:okhttp:3.14.9'
}

3. ProGuard 规则

如果使用ProGuard，需要添加以下规则：

-dontwarn okio.**
-dontwarn javax.annotation.**
-keepclassmembers,allowobfuscation class * {
@com.google.gson.annotations.SerializedName <fields>;
}
-keepclasseswithmembers class * {
@retrofit2.http.* <methods>;
}

-keep class com.loplat.placeengine.cloud.ResponseMessage** {*;}

-keep, allowobfuscation, allowshrinking interface retrofit2.Call
-keep, allowobfuscation, allowshrinking class retrofit2.Response

4. 实现监听器

实现PlengiListener接口来接收位置识别结果：

import android.util.Log;
import com.google.gson.Gson;
import com.loplat.placeengine.PlengiListener;
import com.loplat.placeengine.PlengiResponse;

public class LoplatPlengiListener implements PlengiListener {
  private static final String TAG = LoplatPlengiListener.class.getSimpleName();
  
  @Override
  public void listen(PlengiResponse response) {
    try {
      String jsonStr = new Gson().toJson(response);
      Log.d(TAG, jsonStr);
    } catch (Exception ignored) {
      Log.e(TAG, ignored.toString());
    }
  }
}

在MainApplication中注册监听器：

import io.flutter.app.FlutterApplication;

import android.content.Context;
import com.loplat.placeengine.Plengi;

public class MainApplication extends FlutterApplication {
  @Override
  public void onCreate() {
    super.onCreate();

    Context applicationContext = getApplicationContext();
    Plengi plengi = Plengi.getInstance(applicationContext);
    plengi.setListener(new LoplatPlengiListener());
    plengi.setEchoCode("[your_echo_code]");
  }
}

5. iOS 配置

在iOS项目中，修改info.plist文件以添加所需的权限：

<key>NSLocationWhenInUseUsageDescription</key>
<string>Allow location access to provide better services</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>Allow location access to provide better services</string>
<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

在AppDelegate中初始化Plengi并设置代理：

import UIKit
import MiniPlengi

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, PlaceDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    if Plengi.initialize(clientID: "your_client_id", clientSecret: "your_client_secret") == .SUCCESS {
      Plengi.setEchoCode(echoCode: "your_echo_code")
    }
    return true
  }

  func responsePlaceEvent(_ plengiResponse: PlengiResponse) {
    if let echoCode = plengiResponse.echoCode {
      print("Echo Code: \(echoCode)")
    }

    if plengiResponse.result == .SUCCESS {
      if let place = plengiResponse.place {
        if place.event == .ENTER {
          print("User entered a place")
        } else if place.event == .NEARBY {
          print("User is nearby a place")
        }
      }

      if let advertisement = plengiResponse.advertisement {
        print("Advertisement: \(advertisement.title)")
      }
    } else {
      print("Error: \(plengiResponse.errorReason)")
    }
  }
}

6. 启动和停止 Plengi

在Flutter代码中启动和停止Plengi：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:loplat_plengi/loplat_plengi.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  String _engineStatus = "NOT_INITIALIZED";

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

  Future<void> initEngineStatus() async {
    int status = await LoplatPlengiPlugin.getEngineStatus;
    setState(() {
      _engineStatus = status == -1 ? "NOT_INITIALIZED" : "STARTED";
    });
  }

  Future<void> startEngine() async {
    try {
      final res = await LoplatPlengiPlugin.start("loplat", "loplatsecret");
      if (res == 0) {
        int status = await LoplatPlengiPlugin.getEngineStatus;
        setState(() {
          _engineStatus = status == -1 ? "NOT_INITIALIZED" : "STARTED";
        });
      } else {
        setState(() {
          _engineStatus = "FAILED";
        });
      }
    } catch (e) {
      print("Error: $e");
    }
  }

  Future<void> stopEngine() async {
    try {
      final res = await LoplatPlengiPlugin.stop();
      if (res == 0) {
        int status = await LoplatPlengiPlugin.getEngineStatus;
        setState(() {
          _engineStatus = status == -1 ? "NOT_INITIALIZED" : "STOPPED";
        });
      } else {
        setState(() {
          _engineStatus = "FAILED";
        });
      }
    } catch (e) {
      print("Error: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('loplat SDK Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('Engine Status: $_engineStatus'),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: startEngine,
              child: Text('Start Engine'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: stopEngine,
              child: Text('Stop Engine'),
            ),
          ],
        ),
      ),
    );
  }
}