多媒体组件
目录：
摄像机
使用设备的摄像机录制视频的组件。录制视频后，手机上包含剪辑的文件的名称可作为参数提供给 录制完成 事件。
例如，可以使用文件名来设置源 视频播放器 组件的属性。
属性
无
事件
- 录制完成(clip)
- 表示视频是用相机录制的，提供已存储视频的路径。
方法
- 开始录制()
- 录制视频，然后触发
录制完成事件。
照相机
使用相机组件在手机上拍照。
照相机是一个不可见的组件，它使用设备的相机拍照。照片拍摄完成后，手机上包含照片的文件路径可用作 拍摄完成 事件的参数。
例如，该路径可以用作 图像 的 图片 属性。
属性
无
事件
- 拍摄完成(图像位址)
- 拍照完成后调用，文本参数
图像位址是手机上找到图像位置的路径。
方法
- 拍照()
- 拍照，然后触发
拍摄完成事件。
文件选择器
文件选择器组件是一个类似按钮的组件。当用户单击该组件时，将提示他们从系统中选择一个文件。
还可以通过调用其 打开 方法以编程方式打开选择器。
使用文件选择器组件需要 Android 4.4 或更高版本、iOS 11 或更高版本。要求AI伴侣v2.68及以上。
属性
- 操作
- 设置
文件选择器所需的操作。有如下选项：- 选择现有文件：打开现有文件
- 选择目录：打开现有目录
- 选择新文件：创建一个新文件进行保存
- 背景颜色
- 设置
文件选择器的背景颜色，使用RGBA数值表示，如果设置了图像属性，则不能显示背景颜色直到删除图像属性为止。 - 启用
- 设置
文件选择器是否可以被点击。 - 粗体
- 设置
文件选择器的显示字体是否是粗体。（注：有些字体不支持粗体）。 - 斜体
- 设置
文件选择器的显示字体是否是斜体。（注：有些字体不支持斜体）。 - 字体大小
- 设置
文件选择器的字体大小，以像素px为单位。 - 字体
- 设置
文件选择器的字体，目前支持的字体有：default, serif, sans serif, 和 monospace。要使用自定义字体，请将 .ttf 字体文件上传并选中它。
- 高度
- 设置
文件选择器的垂直高度，以像素px为单位。 - 高度百分比
- 设置
文件选择器的垂直高度相对于整个屏幕高度的百分比。 - 图像
- 设置
文件选择器图像的路径，如果同时设置了图像和背景颜色，则仅图像可见。 - MimeType
- 设置选择文件所需的 MIME 类型。
- 选中项
- 返回选定文件的 URI 路径。
- 形状
- 设置
文件选择器的形状，此属性的有效值为：0（默认）1（圆形）2（矩形）3（椭圆形）。如果设置了
图像，则形状将不可见。 - 显示反馈
- 设置
文件选择器指定图像后被按压是否显示视觉反馈。 - 文本
- 设置
文件选择器的显示文本。 - 文本对齐
- 设置
文件选择器文本的对齐方式，有效值有：0（正常；例如，如果文本从左到右书写，则左对齐）1（居中）2（相反；例如，如果文本从左到右书写，则右对齐）。 - 文本颜色
- 设置
文件选择器的文本颜色，使用RGBA数值表示。 - 可见性
- 设置
文件选择器是否显示在屏幕上，值是真则文件选择器显示，假则隐藏。 - 宽度
- 设置
文件选择器的水平宽度，以像素px为单位。 - 宽度百分比
- 设置
文件选择器的水平宽度相对于屏幕宽度的百分比。
事件
- 选择完成()
- 在
文件选择器选框返回其选择结果且属性已设置后，触发该事件。 - 准备选择()
- 单击
文件选择器或使用 打开选框 方法显示选择器时引发的事件。此事件发生在选择器显示之前，可用于在显示选择器之前准备好选择器。
- 获得焦点()
- 表示光标移到
文件选择器按钮上了，因此现在可以单击它。 - 失去焦点()
- 表示光标从
文件选择器按钮上移开，因此现在无法再单击它。 - 被按压()
- 表示
文件选择器按钮被按下。 - 被松开()
- 表示按下的
文件选择器按钮已被放开。
方法
- 打开选框()
- 打开
文件选择器，就像用户单击它一样。
图像选择器
当用户点击 图像选择器 时，打开设备的图片库，用户可以选择图像。选取图像后，选中项 属性返回选中图像的文件名称。
最多返回10个图像，超过则删除之前旧的图像，按时间从旧到新的顺序排列。
属性
- 背景颜色
- 设置
图像选择器的背景颜色，使用RGBA数值表示，如果设置了图像属性，则不能显示背景颜色直到删除图像属性为止。 - 启用
- 设置
图像选择器是否可以被激活和点击。 - 粗体
- 设置
图像选择器的显示字体是否是粗体。（注：有些字体不支持粗体）。 - 斜体
- 设置
图像选择器的显示字体是否是斜体。（注：有些字体不支持斜体）。 - 字体大小
- 设置
图像选择器的字体大小，以像素px为单位。 - 字体
- 设置
图像选择器的字体，目前支持的字体有：default, serif, sans serif, 和 monospace。要使用自定义字体，请将 .ttf 字体文件上传并选中它。
- 高度
- 设置
图像选择器的垂直高度，以像素px为单位。 - 高度百分比
- 设置
图像选择器的垂直高度相对于整个屏幕高度的百分比。 - 图像
- 设置
图像选择器图像的路径，如果同时设置了图像和背景颜色，则仅图像可见。 - 选中项
- 包含所选图像文件的路径。
- 形状
- 设置
图像选择器的形状，此属性的有效值为：0（默认）1（圆形）2（矩形）3（椭圆形）。如果设置了
图像，则形状将不可见。 - 显示交互效果
- 设置
图像选择器指定图像后被按压是否显示视觉反馈。 - 文本
- 设置
图像选择器的显示文本。 - 文本对齐方式
- 设置
图像选择器文本的对齐方式，有效值有：0（正常；例如，如果文本从左到右书写，则左对齐）、1（居中）或2（相反；例如，如果文本从左到右书写，则右对齐）。 - 文本颜色
- 设置
图像选择器的文本颜色，使用RGBA数值表示。 - 可见性
- 设置
图像选择器是否显示在屏幕上，值是真则图像选择器显示，假则隐藏。 - 宽度
- 设置
图像选择器的水平宽度，以像素px为单位。 - 宽度百分比
- 设置
图像选择器的水平宽度相对于屏幕宽度的百分比。
事件
- 选择完成()
- 在
图像选择器活动返回其结果和属性时触发该事件。 - 准备选择()
- 单击
图像选择器或使用打开选框方法显示选择器时触发该事件，此事件发生在选择器显示之前。 - 获得焦点()
- 表示光标移动到
图像选择器上，现在可以点击它。 - 失去焦点()
- 表示光标从
图像选择器移开，现在它不可再被点击。 - 被按压()
- 表示
图像选择器被按下。 - 被松开()
- 表示
图像选择器被松开。
方法
- 打开选框()
- 打开
图像选择器，就像用户点击它一样。
音频播放器
播放音频和控制手机振动的多媒体组件。多媒体文件名称在源文件 属性中指定，在界面设计和程序设计视图中都可以进行设置。
振动的时长只能在程序设计视图中指定，单位是ms毫秒（千分之一秒）。
有关支持的音频格式，请参阅Android支持的媒体格式。
音频播放器组件尤其适合时间较长的声音文件（例如歌曲）；而音效 组件播放时间较短的声音文件则更高效（例如音效）。
属性
- 播放状态
- 报告
音频播放器是否正在播放。正在播放返回真，没有在播放则返回假。 - 循环播放
- 如果为
真，则音频播放器播放时将循环播放。正在播放时设置“循环播放”直接对当前播放生效。 - 只能在前台运行
- 如果为
真，则音频播放器在离开当前屏幕时将暂停播放； 如果为假（默认选项），则无论当前屏幕是否显示，音频播放器都会继续播放。 - 源文件
- 设置音频源文件。
- 音量
- 将音量属性设置为 0 到 100 之间的数字。小于 0 的值将被视为 0，大于 100 的值将被视为 100。
事件
- 已播放完成时()
- 表示媒体播放已结束。
- 其他播放器启动时()
- 当另一个播放器开始播放时（并且当前播放器正在播放或暂停，但未停止），会触发此事件。
方法
- 暂停()
- 如果媒体正在播放，则暂停播放。
- 开始()
- 播放媒体。如果之前暂停，则恢复播放。
如果之前已停止，则从头开始播放。
- 停止()
- 停止播放媒体，播放进度清零（即下次从头开始播放）。
- 振动(毫秒数)
- 手机振动指定的毫秒数。
音效
一种多媒体组件，可播放声音文件并根据播放次数选择振动几ms毫秒（千分之一秒），在程序设计视图中指定。声音文件的名称可以在界面设计或程序设计视图中指定。
有关支持的声音文件格式，请参阅Android支持的媒体格式。
音效组件适合播放短声音文件（例如音效）；而音频播放器组件播放较长的声音文件更高效（例如歌曲）。
属性
- 最小间隔（毫秒）
- 指定调用
播放之间所需的最小间隔（以毫秒为单位）。一旦声音开始播放，所有后续的
播放调用都将被忽略，直到间隔结束。 - 源文件
- 声音文件的名称。
仅支持某些格式，请参阅http://developer.android.com/guide/appendix/media-formats.html。
事件
无
方法
- 暂停()
- 如果正在播放声音，则暂停播放。
- 播放()
- 播放声音。
- 恢复()
- 暂停后继续播放声音。
- 停止()
- 如果正在播放声音，则停止播放。
- 振动(毫秒数)
- 手机振动指定的毫秒数。
录音机
录制音频的多媒体组件。
属性
- 录音文件路径
- 指定应存储录音文件的路径。
如果此属性为空字符串，则开始录制将在适当的位置创建一个文件；如果该属性不是空字符串，则应指定现有目录中文件的完整路径，包括扩展名如 .3gp 的文件名。
事件
- 录制完成时(录音文件路径)
- 表示新创建的录音已完成，
录音文件路径提供录音文件的存储路径。 - 开始录制时()
- 表示录音机已启动，可以停止。
- 停止录制时()
- 表示录音机已停止，可以重新启动。
方法
- 开始()
- 开始录音。
- 停止()
- 停止录音。
语音识别器
使用 语音识别器 组件来收听用户说话并转换语音，使用设备的语音识别功能转换为文本。
中文网拓展：
-
中文的话，推荐使用“讯飞语音+”识别引擎，识别率较高，点此下载apk安装。
-
安装完成后无需设置，当触发需要识别语音时，系统会弹出对话框让你选择使用哪个识别引擎，这时选择“讯飞语音+”，点“始终”就OK了。
-
当设置语音改成英语后，读中文的话，不是将你读的中文翻译成英文，而是将你读中文的音调相近的英语内容识别出来，也就是它认为你说的是英文，按英文规则识别。
属性
- 语言
- 指定用于识别语音的语言，空字符串（默认值）将使用系统的默认语言。
使用 语言标签 指定语言带有可选的区域后缀，例如 en 或 zh-CN，支持的语言集因设备而异。
- 结果
- 返回识别器生成的最后一个文本。
- 使用兼容模式
- 如果为真，则使用单独的对话框来识别语音（默认）；如果为假，则语音在后台识别，并在识别新的内容时更新。
部分结果设置为真时，识别完成可能会触发多次。一旦自上次说话以来经过了足够的时间，或者调用了
停止识别，最后一个文本结果将返回，并将部分结果设置为假以表示它是最终识别的字符串，之后不再会有更多结果返回，除非再次开始识别。更多详细信息请参考识别完成。
事件
- 识别完成(返回结果,部分结果)
- 在
语音识别器识别语音后触发该事件。如果
使用兼容模式是真，那么这个事件在识别的最后只会触发一次；如果
使用兼容模式是假，那么这个事件将触发多次，因为语音识别器会逐渐识别语音，在这种情况下，部分结果将是真。直至语音识别已完成（例如，用户已停止说话），在这种情况下，
部分结果将是假。 - 准备识别()
- 在调用
语音识别器之前触发该事件。
方法
- 识别语音()
- 要求用户说话，并将语音转换为文本。当结果可用时，将触发
识别完成事件。 - 停止()
- 用于在
语音识别器无法自动停止的情况下强制停止收听语音的功能。仅当
使用兼容模式属性设置为假时，此函数才有效。
文本朗读器
文本朗读器 组件会大声朗读给定的文本，你可以设置音高和语速。
你还可以通过提供语言代码来设置语言，这将改变单词的读法，而不是实际使用的语言。
例如，将 语言 设置为法语，并且说英语文本，听起来就像有人说带有法国口音的英语 (en)。
你还可以通过提供 国家 代码来指定国家/地区，这会影响发音。例如，英国英语 (GBR) 听起来与美国英语 (USA) 不同，并非每个国家/地区代码都会影响每种语言。
可用的语言和国家/地区取决于特定设备，并且可以使用 可用语言 和 可用国家 属性列出。
中文网拓展：
- 经过测试，在“系统设置” — “语言和输入”—“文本转语音” 中将首选引擎设置为讯飞后，朗读出来的内容完全就是杂乱的，不知是不是因为版本过旧，还是其他设置问题，经过一系列尝试（包括设置文本朗读器的国家及语言属性）仍然是不行的。最终只得选择“Google文字转语言引擎”（语音设置为”中文“），中文朗读的效果也非常不错。
属性
- 支持的国家
- 此设备上可用于
语音识别器的国家/地区代码列表。参考 Android 开发文档以查找这些支持国家缩写的含义。 - 支持的语言
- 此设备上可用于
语音识别器的语言列表。参考 Android 开发文档以查找这些支持语言缩写的含义。 - 国家
- 用于语音生成的国家/地区代码，这会影响发音。例如，英国英语 (GBR) 听起来与美国英语 (USA) 不同。并非每个国家/地区代码都会影响每种语言。
- 语言
- 设置
语音识别器的语言。这改变了单词的发音方式，而不是实际所说的语言。例如，将语言设置为法语并说英语文本听起来就像有人说带有法国口音的英语。 - 音调
- 设置
语音识别器的语音音高。这些值应介于 0 和 2 之间，其中较小的值会降低合成语音的音调，较大的值会提高合成语音的音调。
正常音高的默认值为 1.0。
- 结果
- 如果文本成功转换为语音，则返回
真，否则返回假。 - 语速
- 设置
语音识别器的语音语速。这些值应介于 0 和 2 之间，较低的值会减慢音调，较大的值会加快音调。
正常语速的默认值为 1.0。
事件
- 念读结束时(返回结果)
- 念读消息后触发该事件。如果消息被成功读出，则
返回结果将为true，否则将为假。 - 开始念读时()
- 在调用
文本朗读器念读消息之前触发该事件。
方法
- 念读(消息)
- 念读给定的消息。
翻译器
使用此组件在不同的语言之间翻译单词和句子。该组件需要 Internet 访问，因为它将从麻省理工学院（MIT）的服务器请求翻译（也可切换成请求商业翻译服务）。
中文网注：最终实际使用的是国外的Yandex翻译引擎。
以 源语言-目标语言 的形式指定源语言和目标语言使用两个字母的语言代码。因此 en-zh 将翻译自英语翻译成中文，而 zh-en 将从中文翻译成英语。
如果省略源语言，该服务将尝试检测源语言。因此只提供 zh 将尝试检测源语言并将其翻译成中文。
注意： 翻译在后台异步进行，翻译完成后，获取翻译内容 事件将被触发。
属性
- ApiKey
- 要使用的API密钥，默认会自动填写此内容值，不需要更改它。
默认情况下无法访问MIT代理服务器，如需有效API密钥请参照《App Inventor 2 使用MIT代理的组件访问令牌的获取方法》。
事件
- 获得译文(响应代码,译文)
- 请求已完成并已返回数据（翻译）时触发该事件。
方法
- 请求翻译(待翻译至语言,待翻译文本)
- 通过提供要翻译的目标语言（例如，西班牙语的“es”、英语的“en”或俄语的“ru”）以及要翻译的单词或句子，此方法将请求翻译。一旦外部服务翻译了文本，事件
获得译文将被触发。注意： 翻译器将尝试检测源语言。你还可以指定将其添加到语言翻译之前，例如 es-ru 将指定西班牙语到俄语的翻译。
视频播放器
能够播放视频的多媒体组件。当应用程序运行时，视频播放器将在屏幕上显示为一个矩形。
如果用户触摸矩形，将在视频中出现播放、暂停、向前跳转和向后跳转控件。
App可以通过调用 播放、暂停 和 跳转 方法来控制视频播放器的行为。
视频文件应为 3GPP (.3gp) 或 MPEG-4 (.mp4) 格式。更多详细信息格式，见 Android 支持的媒体格式。
App Inventor 只允许 1 MB 以下的视频文件，并将应用程序的总大小限制为 5 MB，并非所有文件都可用于媒体（视频、音频和声音）文件。如果媒体文件太大，打包或安装应用程序时可能会出错，在这种情况下，你应该减少媒体文件的数量或它们的大小。大多数视频编辑软件，例如 Windows Movie Maker 和 Apple iMovie，可以帮助你减小视频的大小，或将视频重新编码为更紧凑的格式。
你还可以将媒体源设置为指向流式视频的 URL，但该 URL 必须指向视频文件本身，而不是播放视频的程序。
属性
- 全屏模式
- 设置视频是否应全屏显示。
- 高度
- 设置
视频播放器的垂直高度，以像素px为单位。 - 高度百分比
- 设置
视频播放器的垂直高度相对于整个屏幕高度的百分比。 - 源文件
- 设置视频文件的路径。通常，在程序包资源中这将是视频文件的名称。
- 可见性
- 设置
视频播放器是否显示在屏幕上，值是真则视频播放器显示，假则隐藏。 - 音量
- 将音量属性设置为 0 到 100 之间的数字。小于 0 的值将被视为 0，大于 100 的值将被视为 100。
- 宽度
- 设置
视频播放器的水平宽度，以像素px为单位。 - 宽度百分比
- 设置
视频播放器的水平宽度相对于屏幕宽度的百分比。
事件
- 已播放完成时()
- 表示视频播放已结束。
免费技术交流群
扫码添加客服咨询
