flutter_oembed 1.0.1-alpha

A Flutter package for embedding social media content (X, TikTok, Instagram, Facebook, YouTube, Spotify, Vimeo, and more) using the OEmbed protocol with WebView rendering.

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:flutter_oembed/flutter_oembed.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:flutter_quill/flutter_quill.dart';
import 'package:embed_example/utils/settings_controller.dart';
import 'package:embed_example/utils/url_launcher_utils.dart';
import 'package:embed_example/pages/home_page.dart';
import 'package:embed_example/widgets/embed_placeholder.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

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

class _MyAppState extends State<MyApp> {
  final ExampleSettingsController _settingsController =
      ExampleSettingsController();

  @override
  Widget build(BuildContext context) {
    return ExampleSettingsProvider(
      notifier: _settingsController,
      child: ListenableBuilder(
        listenable: _settingsController,
        builder: (context, _) {
          final settings = _settingsController.settings;
          return EmbedScope(
            config: EmbedConfig(
              locale: settings.locale,
              brightness: settings.brightness,
              providers: EmbedProviderConfig(
                // Only allow these providers (comment out to enable all)
                // enabledProviders: {'YouTube', 'Spotify', 'Vimeo', 'TikTok', 'SoundCloud'},
                providerRenderModes: {
                  // Use iframe mode for YouTube & Spotify (skips OEmbed API)
                  'YouTube': EmbedRenderMode.iframe,
                  'Spotify': EmbedRenderMode.iframe,
                },
              ),
              cache: const EmbedCacheConfig(
                enabled: true,
                defaultCacheDuration: Duration(hours: 12),
                respectApiCacheAge: true,
              ),
              // Meta (Facebook, Instagram, Threads) API Keys
              // Required for these providers to load correctly via oEmbed
              // facebookAppId: 'YOUR_APP_ID',
              // facebookClientToken: 'YOUR_CLIENT_TOKEN',
              onLinkTap: (url, data) {
                debugPrint(
                  'User clicked on link: $url (Provider: ${data?.providerName})',
                );
                if (url.contains('google.com')) {
                  ScaffoldMessenger.of(context).showSnackBar(
                    const SnackBar(
                      content: Text('Blocking navigation to Google'),
                    ),
                  );
                } else {
                  openUrl(url);
                }
              },
              style: EmbedStyle(
                errorBuilder: (context, error) {
                  return const SocialEmbedErrorPlaceholder(
                    embedType: EmbedType.other,
                  );
                },
              ),
              logger: const EmbedLogger.enabled(),
            ),
            child: MaterialApp(
              title: 'OEmbed Example',
              themeMode:
                  settings.brightness == Brightness.light
                      ? ThemeMode.light
                      : ThemeMode.dark,
              theme: ThemeData(
                colorScheme: ColorScheme.fromSeed(
                  seedColor: Colors.blue,
                  brightness: Brightness.light,
                ),
                useMaterial3: true,
              ),
              darkTheme: ThemeData(
                colorScheme: ColorScheme.fromSeed(
                  seedColor: Colors.blue,
                  brightness: Brightness.dark,
                ),
                useMaterial3: true,
              ),
              localizationsDelegates: const [
                GlobalMaterialLocalizations.delegate,
                GlobalWidgetsLocalizations.delegate,
                GlobalCupertinoLocalizations.delegate,
                FlutterQuillLocalizations.delegate,
              ],
              supportedLocales: const [
                Locale('en'),
                Locale('zh'),
                Locale('ms'),
              ],
              home: const MyHomePage(),
            ),
          );
        },
      ),
    );
  }
}