Using Flutter

You can use Plaud’s iOS SDK in Flutter through a Flutter plugin. Use our plaud_sdk plugin as a starter template for:

Connecting to Plaud Devices
Syncing audio files
Transcription

For advanced usage of the Embedded SDK methods for use cases like WiFi fast transfers, we recommend adding more methods to this plugin or using the native Embedded iOS SDK directly

How it works

Flutter uses platform channels to let your Flutter app call native platform code. A plugin packages that native code so it can be dropped into any Flutter app. Plaud Embedded’s plugin can be added as a path dependency, imported as a typed Dart library, and ran as native code via the Embedded iOS SDK.

 your Flutter code
        │  import 'package:plaud_sdk/plaud_sdk.dart'
        ▼
 ┌─────────────────────────────┐
 │ Dart layer  (lib/*.dart)    │  static PlaudSdk API, fully typed,
 │                             │  guard with isPlaudSdkAvailable off-iOS
 └─────────────────────────────┘
        │  MethodChannel (calls) / EventChannel (typed streams)
 ┌─────────────────────────────┐
 │ Plaud native SDK            │  three precompiled .xcframeworks
 │ (ios/Frameworks/*)          │  BLE / Device / WiFi
 └─────────────────────────────┘

Plaud’s Flutter plugin uses a MethodChannel for method calls and an EventChannel for event listening, passing data between the Dart layer and the native SDK.

Running the Demo App

The demo app is included in the Plaud Embedded Flutter repo as reference for implementing the plugin in your own app and seeing how it works.

Clone the Embedded Flutter repo

git clone https://github.com/Plaud-AI/embedded-flutter.git

Install dependencies and set up env vars

cd embedded-flutter
flutter pub get
cp .env.example .env

You can retrieve your environment credentials from the developer portal and generate a token from our API playground

Set your signing team and run on a device

Open ios/Runner.xcworkspace once to set your Apple developer team (Runner → Signing & Capabilities).

Then run on a physical device to test out the demo app with your Plaud devices. Credentials are compile-time defines, so --dart-define-from-file=.env is required on every run.

flutter run --dart-define-from-file=.env

How to Integrate with your Flutter App

Try the Embedded Flutter Skill to upload this doc and the codebase context for your agent.

npx skills add Plaud-AI/embedded_flutter

Prerequisites

Tool	Notes
Flutter	Dart SDK 3.12+
Xcode	15.x+, with a physical iPhone + Apple ID
CocoaPods	`brew install cocoapods`
iOS deployment target	14.0 (the Plaud frameworks require it)

Step 1: Clone the Plaud Embedded Flutter Repo

git clone https://github.com/Plaud-AI/embedded-flutter.git

This repo includes:

Flutter plugin (plugins/plaud_sdk) for the Plaud iOS SDK for basic functionality
Example Flutter app
Skill for implementing the Plaud Embedded plugin within projects

Step 2: Copy the Plaud Embedded Plugin into your App

At the root of your Flutter project, copy plugins/plaud_sdk into your project’s plugins directory.

cp -R plugins/plaud_sdk your-app/plugins/plaud_sdk

Then depend on the plugin via a path reference in your pubspec.yaml:

pubspec.yaml

dependencies:
  plaud_sdk:
    path: plugins/plaud_sdk

flutter pub get

Flutter’s plugin autolinking handles importing the plaud_sdk plugin; no extra configuration is needed.

Step 3: Configure iOS

Set the deployment target to 15.1 in ios/Podfile (platform :ios, '15.1') and the Runner Xcode target — the Plaud frameworks require it, don’t go lower. Then add BLE permissions to ios/Runner/Info.plist for the Plaud SDK to leverage iOS’s native bluetooth functionality (without the first key, the app hard-crashes the moment it touches Bluetooth).

Info.plist

<key>NSBluetoothAlwaysUsageDescription</key>
<string>Plaud uses Bluetooth to connect to your recorder and sync recordings.</string>
<key>UIBackgroundModes</key>
<array>
  <string>bluetooth-central</string>
</array>

Step 4: Use the Plaud SDK from Flutter

You can now import the plaud_sdk library and use the Embedded iOS SDK straight from your Flutter project in Dart. Guard every call with isPlaudSdkAvailable, init once, subscribe to the streams, then drive it — and cancel your subscriptions in dispose().

import 'package:plaud_sdk/plaud_sdk.dart';

if (!isPlaudSdkAvailable) { /* off-device: show a "device required" state */ }

await PlaudSdk.initSDK(
  userAccessToken: token,               // per-user Bearer JWT
  customDomain: 'platform-us.plaud.ai', // domain only, no https://
  userId: 'your-app-user-id',           // default connect deviceToken
);

final subs = <StreamSubscription>[
  PlaudSdk.onScanResult.listen((devices) {/* show devices */}),
  PlaudSdk.onConnectState.listen((s) {
    if (s.connected) PlaudSdk.getFileList();   // load recordings on connect
  }),
  PlaudSdk.onFileList.listen((files) {/* show recordings */}),
  PlaudSdk.onExportProgress.listen((p) {/* p.progress (0–100), p.message */}),
];

await PlaudSdk.startScan();
await PlaudSdk.connectBleDevice(uuid: device.uuid);   // from an onScanResult device
final export = await PlaudSdk.exportAudio(
  sessionId: file.sessionId,
  format: PlaudAudioFormat.mp3,
);
// export.outputPath → the decoded mp3 under Documents/PlaudExports

for (final s in subs) { s.cancel(); }

Step 5: Run Your App

flutter pub get
flutter run --dart-define-from-file=.env # physical iPhone required

For the full list of relevant SDK methods for interacting with Plaud devices, see our iOS SDK reference.

Overview

Embedded SDK Reference

API Reference

Starter Apps & Guides

Resources

How it works

Running the Demo App

How to Integrate with your Flutter App

Prerequisites

Step 1: Clone the Plaud Embedded Flutter Repo

Step 2: Copy the Plaud Embedded Plugin into your App

Step 3: Configure iOS

Step 4: Use the Plaud SDK from Flutter

Step 5: Run Your App

​How it works

​Running the Demo App

​How to Integrate with your Flutter App

​Prerequisites

​Step 1: Clone the Plaud Embedded Flutter Repo

​Step 2: Copy the Plaud Embedded Plugin into your App

​Step 3: Configure iOS

​Step 4: Use the Plaud SDK from Flutter

​Step 5: Run Your App

How it works

Running the Demo App

How to Integrate with your Flutter App

Prerequisites

Step 1: Clone the Plaud Embedded Flutter Repo

Step 2: Copy the Plaud Embedded Plugin into your App

Step 3: Configure iOS

Step 4: Use the Plaud SDK from Flutter

Step 5: Run Your App