Flutter增强现实开发插件jmap_ar_sdk的使用

Flutter增强现实开发插件jmap_ar_sdk的使用

本Flutter插件将增强现实（AR）功能与Jibestream室内地图集成。在设置过程中，你需要对iOS和Android平台进行特定的配置以设置Jibestream SDK。请遵循以下步骤确保你的Flutter应用程序正确配置。

前提条件

• Flutter SDK（最新稳定版本）
• Xcode（用于iOS开发）
• Android Studio（用于Android开发）
• CocoaPods（用于iOS依赖管理）

安装

要安装该插件，请将其添加到你的Flutter项目的pubspec.yaml文件中：

dependencies:
  jmap_ar_sdk: ^1.2.0

然后运行以下命令以获取包：

flutter pub get

iOS配置

iOS配置需要对你的AppDelegate.swift文件进行一些本地代码更改。请按以下步骤操作：

1. 在Xcode中打开你的Flutter项目，导航到ios目录并打开Runner.xcworkspace文件。
2. 在AppDelegate.swift文件的didFinishLaunchingWithOptions方法中，添加以下代码：

let options: [String: String] = [
    "GOOGLE_APP_ID": "",
    "GCM_SENDER_ID": "",
    "API_KEY": "",
    "PROJECT_ID": "",
    "DATABASE_URL": "",
    "STORAGE_BUCKET": ""
]

UserSDK.configure(with: options)

你还可以添加以下辅助函数来读取GoogleService-Info.plist文件：

func getGoogleServiceInfo() -> [String: String]? {
    // 直接从主包中访问GoogleService-Info.plist文件
    guard let filePath = Bundle.main.path(forResource: "GoogleService-Info", ofType: "plist"),
          let plistData = NSDictionary(contentsOfFile: filePath) as? [String: Any] else {
        print("Failed to load GoogleService-Info.plist")
        return nil
    }

    // 从plist数据中检索所需键值
    let keysToExtract = ["GOOGLE_APP_ID", "GCM_SENDER_ID", "API_KEY", "PROJECT_ID", "DATABASE_URL", "STORAGE_BUCKET"]
    var googleServiceInfoDict: [String: String] = [:]

    for key in keysToExtract {
        if let value = plistData[key] as? String {
            googleServiceInfoDict[key] = value
        }
    }

    return googleServiceInfoDict
}

1. 确保将GoogleService-Info.plist文件添加到你的Xcode项目中。此文件对于SDK配置是必需的。
2. 如果你的应用使用了Firebase，请确保在Podfile中添加以下内容：

$FirebaseSDKVersion = '10.29.0' # Google Cloud Anchor仅支持此版本

这行代码应该添加在target 'Runner' do行之前。

Android配置

对于Android，你需要修改MainActivity.kt文件。请按以下步骤操作：

1. 在Android Studio中打开你的Flutter项目。
2. 在android/build.gradle文件中添加以下两行：

maven { url "https://cxapp.jfrog.io/artifactory/android-cxapp/" }
maven { url "https://jitpack.io" }

1. 在MainActivity.kt文件中，添加以下代码：

import com.cxapp.sdk.ar.user.ARUserSDK

override fun onCreate(savedInstanceState: Bundle?) {
    val dataConfig = HashMap<String, String>()
    dataConfig["projectId"] = ""
    dataConfig["applicationId"] = ""
    dataConfig["apiKey"] = ""

    ARUserSDK.configure(dataConfig)
    super.onCreate(savedInstanceState)
}

1. 确保在AndroidManifest.xml文件中包含AR和Jibestream SDK所需的必要权限和依赖项。

Flutter使用

void _startLocalization() {
  final jMapARSDK = JMapARSDK();
  final config = JMapConfig(
      'https://api.jibestream.com',
      '', // Client ID
      '', // Client Secret
      123, // Customer ID
      123, // Venue ID
      123, // Building ID
      123); // Floor ID
  jMapARSDK.startLocalization(config);
}

示例代码

以下是完整的示例代码：

import 'package:flutter/material.dart';
import 'package:jmap_ar_sdk/jmap_ar_sdk.dart';
import 'package:jmap_ar_sdk/jmap_config.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> {
  final _jmapArSdkPlugin = JMapARSDK();

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

  void _startLocalization() {
    JMapConfig mapConfig = const JMapConfig(
        "https://api.jibestream.com",
        "", // Client ID
        "", // Client Secret
        123, // Customer ID
        123, // Venue ID
        123, // Building ID
        123); // Floor ID
    _jmapArSdkPlugin.startLocalization(mapConfig);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: _startLocalization,
            child: const Text('Start Localization'),
          ),
        ),
      ),
    );
  }
}