Flutter音量控制插件real_volume的使用

发布于 1周前 作者 nodeper 来自 Flutter

Flutter音量控制插件real_volume的使用

简介

real_volume 是一个Flutter插件，提供了对音量和音频相关设置的便捷访问，包括获取不同流类型的音量级别、监听音量变化、更改音量级别、获取和更改音频模式、获取和更改铃声模式等。此外，它还支持打开勿扰模式设置以及检查勿扰权限状态。

功能特性

  • 根据流类型获取音量级别
  • 使用监听器检测音量级别变化
  • 更改任何流类型的音量级别
  • 获取音频模式
  • 更改音频模式（？）
  • 获取铃声模式
  • 使用监听器检测铃声模式变化
  • 更改铃声模式
  • 打开勿扰模式设置
  • 检查勿扰权限状态

使用方法

Android配置

权限说明

大多数情况下不需要额外权限。但要切换“勿扰模式”，需要在 AndroidManifest.xml 中添加以下权限：

<manifest ... >
    <uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY"/>

    <application ... >
    ...
</manifest>

对于Android 6.0及以上的设备，还需要用户授予“勿扰访问”权限。可以使用以下代码检查并请求权限：

import 'package:real_volume/real_volume.dart';

bool? isPermissionGranted = await RealVolume.isPermissionGranted();

if (!isPermissionGranted!) {
  // 打开勿扰设置以授予访问权限
  await RealVolume.openDoNotDisturbSettings();
}

iOS支持的功能

  • getMaxVol
  • getMinVol
  • getCurrentVol
  • setVolume
  • getRingerMode (返回 RingerMode.SILENT 或 RingerMode.NORMAL)

支持的监听器

  • onVolumeChanged
  • onRingerModeChanged (事件为 RingerMode.SILENT 或 RingerMode.NORMAL)

注意：

  1. 对于iOS设备，streamType 参数会被忽略。
  2. 如果在订阅 onRingerModeChanged 监听器后调用 getRingerMode，监听器将停止工作。因此，如果在同一项目中同时使用这两个功能，需在调用 getRingerMode 后取消并重新订阅监听器。

API示例

获取铃声模式

import 'package:real_volume/real_volume.dart';

RingerMode? ringerMode = await RealVolume.getRingerMode();
print(ringerMode?.name ?? 'Unknown');

设置铃声模式

import 'package:real_volume/real_volume.dart';

await RealVolume.setRingerMode(RingerMode.SILENT, redirectIfNeeded: false);

获取通知音量

import 'package:real_volume/real_volume.dart';

double notificationVolume = (await RealVolume.getCurrentVol(StreamType.NOTIFICATION)) ?? 0.0;
print(notificationVolume.toString());

设置音乐音量

import 'package:real_volume/real_volume.dart';

await RealVolume.setVolume(0.75, showUI: true, streamType: StreamType.MUSIC);

获取音频模式

import 'package:real_volume/real_volume.dart';

AudioMode? audioMode = await RealVolume.getAudioMode();
print(audioMode?.name ?? 'Unknown');

监听音量变化

import 'package:real_volume/real_volume.dart';

RealVolume.onVolumeChanged.listen((event) async {
    setState(() {
      currentVolume = event.volumeLevel;
      selectedStreamType = event.streamType;
    });
});

示例代码

以下是一个完整的示例应用，展示了如何使用 real_volume 插件来控制音量和管理其他音频设置：

import 'dart:io';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:real_volume/real_volume.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  StreamType? selectedStreamType = StreamType.VOICE_CALL;
  double currentVolume = 0;

  late List<StreamType> menuItems = StreamType.values;
  int sliderDivisions = 10;
  int minVolume = 0;
  int maxVolume = 10;
  RingerMode ringerMode = RingerMode.NORMAL;
  bool showUI = false;

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    RingerMode rMode = (await RealVolume.getRingerMode()) ?? RingerMode.NORMAL;
    setState(() {
      ringerMode = rMode;
    });
    RealVolume.onRingerModeChanged.listen((event) async {
      setState(() {
        ringerMode = event;
      });
      if (Platform.isAndroid) {
        if (selectedStreamType == StreamType.NOTIFICATION ||
            selectedStreamType == StreamType.RING) {
          double curVol =
              (await RealVolume.getCurrentVol(selectedStreamType)) ?? 0;
          setState(() {
            currentVolume = curVol;
          });
        }
      }
    });
    RealVolume.onVolumeChanged.listen((event) {
      onStreamTypeChanged(event.streamType);
    });
    onStreamTypeChanged(selectedStreamType);
    if (!mounted) return;
  }

  onStreamTypeChanged(StreamType? streamType) async {
    int minVol = (await RealVolume.getMinVol(streamType)) ?? 0;
    int maxVol = (await RealVolume.getMaxVol(streamType)) ?? 10;
    double currentVol = (await RealVolume.getCurrentVol(streamType)) ?? 0;
    setState(() {
      minVolume = minVol;
      maxVolume = maxVol;
      currentVolume = currentVol;
      sliderDivisions = maxVol - minVol;
      selectedStreamType = streamType ?? selectedStreamType;
    });
  }

  onValueChanged(double val) async {
    bool? volumeChanged = await RealVolume.setVolume(val,
        showUI: showUI, streamType: selectedStreamType);
    if (volumeChanged!) {
      setState(() {
        currentVolume = val;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Real Volume plugin'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              if (Platform.isAndroid)
                Row(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    const Padding(
                      padding: EdgeInsets.only(right: 8.0),
                      child: Text('Volume Stream Type:'),
                    ),
                    DropdownButton<StreamType>(
                      value: selectedStreamType,
                      items: menuItems.map((StreamType streamType) {
                        return DropdownMenuItem<StreamType>(
                          value: streamType,
                          child: Text(streamType.name),
                        );
                      }).toList(),
                      onChanged: onStreamTypeChanged,
                    ),
                  ],
                ),
              SizedBox(
                width: 200,
                child: CheckboxListTile(
                    title: const Text('Show UI'),
                    value: showUI,
                    onChanged: (val) {
                      setState(() {
                        showUI = val!;
                      });
                    }),
              ),
              Slider(
                divisions: sliderDivisions,
                value: currentVolume,
                onChanged: onValueChanged,
              ),
              Text('Volume: $currentVolume%'),
              Row(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  const Padding(
                    padding: EdgeInsets.only(right: 8.0),
                    child: Text('Ringer Mode:'),
                  ),
                  Platform.isAndroid
                      ? DropdownButton<RingerMode>(
                          value: ringerMode,
                          items: RingerMode.values.map((RingerMode ringerMode) {
                            return DropdownMenuItem<RingerMode>(
                              value: ringerMode,
                              child: Text(ringerMode.name),
                            );
                          }).toList(),
                          onChanged: (value) async {
                            await RealVolume.setRingerMode(value!,
                                redirectIfNeeded: false);
                            RingerMode? rMode =
                                (await RealVolume.getRingerMode());
                            if (rMode != null) {
                              setState(() {
                                ringerMode = rMode;
                              });
                            }
                          })
                      : Text(ringerMode.name),
                ],
              ),
              if (Platform.isAndroid)
                MaterialButton(
                  elevation: 2,
                  color: Colors.grey[100],
                  onPressed: () => RealVolume.openDoNotDisturbSettings(),
                  child: const Text('Open DND Settings'),
                )
            ],
          ),
        ),
      ),
    );
  }
}

这个示例展示了如何在Flutter应用程序中集成和使用 real_volume 插件，包括初始化插件状态、设置音量、选择不同的音量流类型、显示或隐藏音量调整界面、以及处理平台特定的功能如勿扰模式设置等。希望这些信息能帮助你在自己的项目中更好地利用 real_volume 插件。


更多关于Flutter音量控制插件real_volume的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter音量控制插件real_volume的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是如何在Flutter项目中使用real_volume插件来控制音量的代码示例。这个插件允许你访问和控制设备的音量设置，包括媒体音量、铃声音量和警报音量。

1. 添加依赖

首先，在你的pubspec.yaml文件中添加real_volume依赖：

dependencies:
  flutter:
    sdk: flutter
  real_volume: ^latest_version  # 请将latest_version替换为实际的最新版本号

然后运行flutter pub get来获取依赖。

2. 导入插件

在你的Dart文件中导入real_volume插件：

import 'package:real_volume/real_volume.dart';

3. 使用插件

以下是一个完整的示例，展示如何获取当前音量、设置音量以及订阅音量变化事件。

import 'package:flutter/material.dart';
import 'package:real_volume/real_volume.dart';

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  int? currentMediaVolume;
  int? maxMediaVolume;

  @override
  void initState() {
    super.initState();
    // 获取当前媒体音量和最大媒体音量
    _getCurrentAndMaxMediaVolume();

    // 订阅音量变化事件
    RealVolume.mediaVolumeStream.listen((volume) {
      setState(() {
        currentMediaVolume = volume;
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Real Volume Example'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            children: [
              Text('当前媒体音量: ${currentMediaVolume ?? "未知"}'),
              Text('最大媒体音量: ${maxMediaVolume ?? "未知"}'),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () => _setMediaVolume(10),
                child: Text('设置音量到10'),
              ),
              ElevatedButton(
                onPressed: () => _setMediaVolume(maxMediaVolume ?? 0),
                child: Text('设置音量到最大'),
              ),
              ElevatedButton(
                onPressed: () => _increaseMediaVolume(),
                child: Text('增加音量'),
              ),
              ElevatedButton(
                onPressed: () => _decreaseMediaVolume(),
                child: Text('减少音量'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> _getCurrentAndMaxMediaVolume() async {
    try {
      int currentVolume = await RealVolume.getMediaVolume();
      int maxVolume = await RealVolume.getMaxMediaVolume();
      setState(() {
        currentMediaVolume = currentVolume;
        maxMediaVolume = maxVolume;
      });
    } catch (e) {
      print('获取音量失败: $e');
    }
  }

  Future<void> _setMediaVolume(int volume) async {
    try {
      await RealVolume.setMediaVolume(volume);
      // 重新获取当前音量以更新UI
      _getCurrentAndMaxMediaVolume();
    } catch (e) {
      print('设置音量失败: $e');
    }
  }

  Future<void> _increaseMediaVolume() async {
    try {
      int currentVolume = currentMediaVolume ?? 0;
      await RealVolume.adjustMediaVolume(adjustBy: 1);
      // 重新获取当前音量以更新UI
      _getCurrentAndMaxMediaVolume();
    } catch (e) {
      print('增加音量失败: $e');
    }
  }

  Future<void> _decreaseMediaVolume() async {
    try {
      int currentVolume = currentMediaVolume ?? 0;
      await RealVolume.adjustMediaVolume(adjustBy: -1);
      // 重新获取当前音量以更新UI
      _getCurrentAndMaxMediaVolume();
    } catch (e) {
      print('减少音量失败: $e');
    }
  }
}

注意事项

  1. 权限：在某些平台上（特别是Android），可能需要请求音量控制的权限。确保在AndroidManifest.xml中声明必要的权限。
  2. 平台限制：不同的平台（iOS和Android）对音量控制有不同的限制，因此请测试你的应用以确保它在所有目标平台上都能正常工作。

这个示例展示了如何使用real_volume插件在Flutter应用中控制音量。你可以根据需要进一步自定义和扩展这个示例。

回到顶部