media.newRecording()

类型 函数
库 media.*
返回值 录音
修订 版本 2024.3703
关键词 媒体，录音，音频
另请参阅 对象：startRecording
对象：stopRecording
media.playSound()

概述

创建一个用于录音的对象（录音）。

注意事项

通用

tvOS 不支持此 API。

Android

  • 在 Android 上，要在设备上启用录音，您必须在 build.settings 文件中设置权限级别。
settings =
{
    android =
    {
        usesPermissions =
        {
            "android.permission.RECORD_AUDIO",
        },
    },
}
  • 在 Android 上，录制文件的默认格式为 .wav。要录制为 .3gp 格式，只需在路径末尾添加 .3gp。请注意，.3gp 文件只能通过 media.playSound() 函数播放。

iOS

在 iOS 上，要在设备上启用录音，您必须在 build.settings 的 plist 表中包含以下键/描述。当系统提示用户允许访问时，相关的描述将作为警报的一部分显示。请注意，您可以根据自己的喜好自定义这些描述，甚至可以对其进行本地化（指南）。

settings =
{
    iphone =
    {
        plist =
        {
            NSMicrophoneUsageDescription = "This app would like to access the microphone.",
        },
    },
}

语法

media.newRecording( [path] )
路径 （可选）

字符串。 用于记录音频数据的文件的路径。如果未指定文件，则输出将为空。

支持的格式

以下平台只能录制以下音频格式

平台 支持的音频格式
iOS .aif
Android .wav（默认），.3gp（“Nabi 2”平板电脑不支持）
macOS .aif
Windows .wav

示例

local filePath = system.pathForFile( "newRecording.aif", system.DocumentsDirectory )
r = media.newRecording( filePath )
r:startRecording()