如何管理預設藍牙通訊裝置的通話 (HTML)
[ 本文的目標對象是撰寫 Windows 執行階段 App 的 Windows 8.x 和 Windows Phone 8.x 開發人員。如果您正在開發適用於 Windows 10 的 App，請參閱 最新文件 ]
這個教學課程說明如何設定預設的藍牙通訊裝置來處理通話。
您必須知道的事
技術
- Windows Runtime
先決條件
- 您必須熟悉 HTML、JavaScript、Windows 事件和事件處理常式。
- 若要執行這個範例，您需要一部啟用藍牙功能的電腦，而且執行 Windows 8 或更新的作業系統。
指示
步驟 1: Default.html 檔案的程式碼
CallControl 範例使用以下 HTML 指令碼來設定螢幕和 UI 元素，讓您可以體驗它的功能。
- 以下是 CallControl 範例所使用的 HTML 程式碼：
<!DOCTYPE html>
<html>
<head>
<title>Call Control</title>
<!-- WinJS references -->
<link href="winjs/css/ui-light.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="WinJS/js/base.js"></script>
<script type="text/javascript" src="WinJS/js/ui.js"></script>
<script type="text/javascript" src="WinJS/js/wwaapp.js"></script>
<!-- SDK Base references -->
<link rel="stylesheet" type="text/css" href="css/base-sdk.css" />
<script type="text/javascript" src="base-sdk.js"></script>
<!-- Sample references -->
<link rel="stylesheet" type="text/css" href="css/program.css" />
<script type="text/javascript" src="program.js"></script>
</head>
<body role="application">
<div id="rootGrid">
<div id="header" role="contentinfo">
</div>
<div id="content">
<h1>
Call Control</h1>
<h2 id="inputLabel">
Input</h2>
<div id="input" role="main" aria-labelledby="inputLabel">
<div class="options">
<h3 id="listLabel">
Select scenario:</h3>
<select size="4" id="scenarios" aria-labelledby="listLabel">
<option selected="selected" value="1">1) Call Controls</option>
</select>
</div>
<div class="details" role="region" aria-labelledby="descLabel" aria-live="assertive">
<h3 id="descLabel">
Description:</h3>
<!-- Scenario 1 Input -->
<div class="item" id="scenario1Input">
<p>
To use this sample, ensure you have a bluetooth device and press the initialize
the call control button. After initialization you will be able to simulate an incoming
call by pressing the indicate phone call button. Use your bluetooth device to answer
and hang up the call. Redial and dial should work after initialization. Some devices
require a stream to be opened so a file will start playing to the default communications
device.
</p>
<button class="action" id="scenario1Initialize">
Initialize Call Buttons</button>
<button class="action secondary" id="scenario1Ring" disabled="disabled">
Indicate Phone Call</button>
<br />
<br />
</div>
</div>
</div>
<div class="clear">
</div>
<h2 id="outputLabel">
Output</h2>
<div id="output" role="region" aria-labelledby="outputLabel" aria-live="assertive">
<div id="statusMessage">
</div>
<!-- Scenario 1 Output -->
<div class="item" id="scenario1Output">
<audio id="audiotag" src="folk_rock.mp3" msaudiocategory="communications"
msaudiodevicetype="communications" loop>
</audio>
</div>
</div>
</div>
<div id="footer" role="contentinfo">
</div>
</div>
</body>
</html>
步驟 2: Default.js 檔案的程式碼
在初始化的時候，CallControl 範例會設定事件接聽程式並將它們與事件處理常式建立連結，以便回應按鈕，其中包括接聽按鈕和掛斷按鈕。
- 以下是 CallControl 範例所使用的 JavaScript 程式碼：
//// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
//// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
//// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
//// PARTICULAR PURPOSE.
////
//// Copyright (c) Microsoft Corporation. All rights reserved
/// <reference path="base-sdk.js" />
(function () {
// Initialize the call control object here using the default bluetooth communications device
var callControls = null;
var callToken;
var audiotag;
function id(elementId) {
return document.getElementById(elementId);
}
function initDevice() {
if (!callControls) {
try {
callControls = Windows.Media.Devices.CallControl.getDefault();
if (callControls) {
// Add the event listener to listen for the various button presses
callControls.addEventListener("answerrequested", answerButton, false);
callControls.addEventListener("hanguprequested", hangupButton, false);
callControls.addEventListener("audiotransferrequested", audiotransferButton, false);
callControls.addEventListener("redialrequested", redialButton, false);
callControls.addEventListener("dialrequested", dialButton, false);
sdkSample.displayStatus("Call Controls Initialized");
id("scenario1Ring").disabled = false;
} else {
sdkSample.displayError("No Bluetooth device detected.");
}
}
catch (e) {
sdkSample.displayError("No Bluetooth device detected.");
}
}
}
function newIncomingCall() {
// Indicate a new incoming call and ring the headset.
callToken = callControls.indicateNewIncomingCall(true, "5555555555");
sdkSample.displayStatus("Call Token: " + callToken);
}
function answerButton() {
// When the answer button is pressed indicate to the device that the call was answered
// and start a song on the headset (this is done by streaming music to the bluetooth
// device in this sample)
sdkSample.displayStatus("Answer requested: " + callToken);
callControls.indicateActiveCall(callToken);
audiotag = document.getElementById("audiotag");
audiotag.play();
}
function hangupButton() {
// Hang up request received. The application should end the active call and stop
// streaming to the headset
sdkSample.displayStatus("Hangup requested");
callControls.endCall(callToken);
audiotag = document.getElementById("audiotag");
audiotag.pause();
}
function audiotransferButton() {
// Handle the audio transfer request here
sdkSample.displayStatus("Audio Transfer requested");
}
function redialButton(redialRequestedEventArgs) {
// Handle the redial request here. Indicate to the device that the request was handled.
sdkSample.displayStatus("Redial requested");
redialRequestedEventArgs.handled = true;
}
function dialButton(dialRequestedEventArgs) {
// A device may send a dial request by either sending a URI or if it is a speed dial,
// an integer with the number to dial.
if (typeof(dialRequestedEventArgs.contact) === "number") {
sdkSample.displayStatus("Dial requested: " + dialRequestedEventArgs.contact);
dialRequestedEventArgs.handled = true;
}
else {
sdkSample.displayStatus("Dial requested: " + dialRequestedEventArgs.contact.schemeName + ":" +
dialRequestedEventArgs.contact.path);
dialRequestedEventArgs.handled = true;
}
}
function initialize() {
id("scenario1Initialize").addEventListener("click", initDevice, false);
id("scenario1Ring").addEventListener("click", newIncomingCall, false);
id("scenarios").addEventListener("change", onScenarioChanged, false);
}
function onScenarioChanged() {
sdkSample.displayStatus("");
}
document.addEventListener("DOMContentLoaded", initialize, false);
})();
步驟 3: 執行和測試 CallControl 範例
- 此範例的描述中會包含建置、執行及測試此範例的詳細指示。若要查看這個範例的建置以及其他指示，請參閱通話控制項範例。
備註
部分裝置需要先開啟音訊串流，音訊檔案才可以開始播放給預設的通訊裝置。
如需開發人員指導方針，以及在 Windows 市集應用程式中管理通話的最佳做法，請參閱開發音訊感知應用程式的指導方針