Power Apps 中的麥克風控制項
讓應用程式使用者從自己的裝置錄音的控制項。
描述
使用麥克風控制項，透過裝置的麥克風擷取音訊。 裝置必須有一支麥克風，且使用者必須授權應用程式使用麥克風。
最新錄製的音訊剪輯片段可以透過 Audio 屬性使用。 使用此屬性，錄製的音訊可以是：
- 用音訊控制項重新播放。 使用音訊控制項收聽錄製內容。 如需詳細資訊，請參閱 範例。
- 暫時放入變數或集合物件。 使用 Set 或 Collect 函數在變數或集合物件中儲存音訊剪輯片段。 當您在集合物件中使用多個音訊剪輯片段時，請在使用裝置的有限記憶體時務必小心。 使用 SaveData 和 LoadData 函數將音訊剪輯片段移到裝置上的本機儲存區，它適用 離線案例。
- 儲存在資料庫。 使用 Patch 功能在資料庫中儲存音訊剪輯片段。
- 以 base64 編碼文字字串傳輸。 使用 JSON 函數到 base64 編碼音訊剪輯片段。
錄製音訊的格式：
- Android 的 3gp 格式。
- iOS 的 AAC 格式。
- 網頁瀏覽器 的 OGG 格式。
擷取的媒體是由文字字串 URI 參考。 如需詳細資訊，請閱讀 資料類型文件。
注意
僅在以 Chromium 為基礎的 Microsoft Edge、Chrome 及 Firefox 瀏覽器，和 Android 及 iOS 裝置上才支援麥克風控制項。 所有其他瀏覽器和平台都會顯示一則警告，指出應用程式的某些功能無法運作。
限制
麥克風控制項具有下列限制：
- Power Apps Mobile 可在各種類型裝置上執行，其中一些裝置有該平台的特定限制：
- 您可以在 iPhone 裝置以外的所有平台上同時播放多個視訊控制項中的影片。
- 您可以在 Web 播放程式以外的所有平台上同時使用多個麥克風控制項錄製音訊。
索引鍵屬性
Audio – 使用者使用裝置的麥克風錄製時擷取的音訊剪輯片段。
Mic – 在具有一支以上麥克風的裝置上，麥克風的數字識別碼。
OnStop – 當使用者使用麥克風控制項停止錄製時，要執行的動作。
其他屬性
AccessibleLabel – 螢幕報讀軟體的標籤。 應描述麥克風的目的。
BorderColor – 控制項框線的色彩。
BorderStyle – 決定控制項的框線為實線、虛線、點線或無。
BorderThickness – 控制項框線的粗細。
Color – 控制項文字的色彩。
DisplayMode – 控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。
DisabledBorderColor – 如果控制項的 DisplayMode 屬性設定為 Disabled，該控制項框線的色彩。
DisabledColor – 控制項的 DisplayMode 屬性設定為 Disabled 時，該控制項文字的色彩。
DisabledFill – 控制項的 DisplayMode 屬性設定為 Disabled 時，該控制項背景的色彩。
Fill – 控制項背景的色彩。
FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。
FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。
Height – 控制項的頂端和底部邊緣之間的距離。
HoverBorderColor – 使用者將滑鼠游標停留在控制項上時，該控制項框線所呈現的色彩。
HoverColor – 使用者將滑鼠游標停留在控制項上時，該控制項文字所呈現的色彩。
HoverFill – 使用者將滑鼠游標停留在控制項上時，該控制項背景所呈現的色彩。
Image – 出現在圖像、音訊或麥克風控制項中的圖像名稱。
ImagePosition – 畫面中圖像的位置 (Fill、符合、延展、Tile或置中)，或者是控制項中圖像的位置，如果它的大小與影像不同。
OnSelect – 在使用者選擇控制項時，要執行的動作。
OnStart – 當使用者使用麥克風控制項開始錄製時，要執行的動作。
PressedBorderColor – 使用者選取控制項時，該控制項框線所呈現的色彩。
PressedColor – 使用者選取控制項時，該控制項文字所呈現的色彩。
PressedFill – 使用者選取控制項時，該控制項背景所呈現的色彩。
Reset – 控制項是否會還原為其預設值。
TabIndex – 相較於其他控制項的鍵盤導覽順序。
Tooltip – 使用者將滑鼠停留在控制項上時所顯示的說明文字。
Visible – 控制項顯示或隱藏。
Width – 控制項左邊緣與右邊緣之間的距離。
X – 控制項左邊緣與其父容器或畫面左邊緣之間的距離。
Y – 控制項上邊緣與父容器或畫面上邊緣之間的距離。
範例
簡單直接播放
在此範例中，我們會將麥克風控制項與音訊控制項直接連接，以便立即播放：
新增 一個麥克風控制項到您的應用程式。
當出現提示時，授權應用程式使用裝置的麥克風。
新增一個音訊控制項到您的應用程式。
將音訊控制項的 Media 屬性設定為公式：
Microphone1.Audio注意
依適當情況將麥克風控制項的名稱取代為 Microphone1。
預覽應用程式。
選取麥克風控制項開始錄製。
說話以錄製音訊。
再選取麥克風控制項結束錄製。
選取音訊控制項收聽錄製內容。
新增聲音到資源庫控制項
在此範例中，我們將建立一個音訊剪輯片段資源庫並儲存在集合物件中，讓重播可以單獨選取：
新增一個麥克風控制項。
使用 Collect 函數將其 OnStop 屬性設定為以下公式：
Collect( MySounds, MyMic.Audio )新增資源庫控制項，並將它移至 MyMic 下方。
將資源庫的 Items 屬性設定為以下公式︰
MySounds在自訂資源庫控制項的範本中，新增 音訊控制項。
將音訊控制項的 Media 屬性設定以下公式：
ThisItem.Url按 F5 鍵預覽應用程式。
選取 MyMic 開始錄製，然後再次選取它停止錄製。
在資源庫控制項中，選取音訊控制項中的播放按鈕來播放您的錄製。
視需要加入想要的錄製內容，然後按下 Esc 鍵返回預設工作區。
(非必要) 在資源庫控制項的範本中，新增按鈕控制項。
將其 OnSelect 屬性設定為下列公式：
Remove( MySounds, ThisItem )按 F5 鍵，然後選取對應的按鈕控制項移除錄製。
使用 SaveData 函數在本機儲存錄製內容或 Patch 函數更新資料來源。
協助工具指南
適用與 按鈕相同的指南，因為麥克風只是特製化的按鈕。 也請考慮：
音訊替代項目
請考慮為有言語障礙或沒有麥克風的使用者加入替代形式的輸入。 例如，文字輸入讓使用者輸入文字。
色彩對比
螢幕助讀程式支援
- AccessibleLabel 必須存在。