共用方式為

WebUIContactCallActivatedEventArgs 類別

  • 參考

定義

命名空間:
Windows.UI.WebUI
編輯

在應用程式啟動時提供資料，以呼叫連絡人。

public ref class WebUIContactCallActivatedEventArgs sealed : IActivatedEventArgs, IContactCallActivatedEventArgs, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactCallActivatedEventArgs final : IActivatedEventArgs, IContactCallActivatedEventArgs, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactCallActivatedEventArgs : IActivatedEventArgs, IContactCallActivatedEventArgs, IActivatedEventArgsDeferral
Public NotInheritable Class WebUIContactCallActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactCallActivatedEventArgs
繼承
Object Platform::Object IInspectable WebUIContactCallActivatedEventArgs
屬性
ContractVersionAttribute MarshalingBehaviorAttribute
實作
IActivatedEventArgs IContactActivatedEventArgs IContactCallActivatedEventArgs IActivatedEventArgsDeferral

Windows 需求

裝置系列
Windows Desktop Extension SDK (已於 10.0.10240.0 引進)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (已於 v1.0 引進)

範例

JavaScript

function activated(eventObject) {
    if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.contact) {
        if (eventObject.detail.verb === Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.call) {

     //get contact display info
            var contactName = eventObject.detail.contact.displayName;
            var contactThumbnail = eventObject.detail.contact.thumbnail;

            if (eventObject.detail.serviceId === "telephone") {
                var phoneNumber = eventObject.detail.serviceUserId;
  //add calling logic for PSTN numbers
            }
     else if (eventObject.detail.serviceId === "skype.com") {
                var userId = eventObject.detail.serviceUserId;
  //add calling logic for Skype Ids
            }
        }
    }
}

備註

當您在與ActivationKind連絡時實作WinJS.Application.Onactivated或Windows.UI.WebUI.WebUIApplication.activated事件的事件處理常式時，就會存取此物件。

注意

這個類別不是敏捷式的，這表示您需要考慮其執行緒模型和封送處理行為。 如需詳細資訊，請參閱 執行緒和封送處理 (C++/CX) 。

Windows 8.1可讓使用者從連絡人卡片或 Windows 搜尋體驗呼叫其連絡人。 藉由實作連絡人通話啟用合約，Windows 可以啟動您的應用程式來撥打使用者的電話。

若要接收通話啟用，您的應用程式必須在其資訊清單中註冊 「windows.contact」 擴充功能類別。 在此延伸模組下，您必須包含 「Verb」 屬性等於 「call」 的 「LaunchAction」 元素。然後，您可以指定 「ServiceId」 元素，以指定您支援的呼叫類型。 例如，如果您的應用程式處理標準 PSTN 通話，您可以指定 「ServiceId」 為 「telephone」。如果您的應用程式處理透過 Web 服務呼叫，例如 Skype，您可以指定該服務的功能變數名稱，例如「skype.com」。

如果有多個應用程式已註冊此合約，使用者可以選擇其中一個應用程式作為處理呼叫的預設值。

注意

若要讓使用者將您的應用程式設定為 PSTN 號碼的預設通話應用程式，您的應用程式也必須支援 「tel」 URI 配置。

以下是資訊清單註冊的範例：

<m2:Extension Category="windows.contact" xmlns:m2="http://schemas.microsoft.com/appx/2013/manifest">
  <m2:Contact>
    <m2:ContactLaunchActions>
      <m2:LaunchAction Verb="call" DesiredView="useLess">
        <m2:ServiceId>telephone</m2:ServiceId>
        <m2:ServiceId>skype.com</m2:ServiceId>
      </m2:LaunchAction>
    </m2:ContactLaunchActions>
  </m2:Contact>
</m2:Extension>

在資訊清單中註冊之後，即可針對連絡人通話合約啟用您的應用程式。 啟動應用程式時，您可以使用事件資訊來識別呼叫啟用，並擷取參數，以協助您完成使用者的呼叫。

以下是您需要處理 PSTN 號碼和 Skype 識別碼連絡人通話啟用的程式碼範例：

屬性

ActivatedOperation

取得應用程式啟動的作業。
Contact

取得通話的連絡人。
Kind

取得啟用類型。
PreviousExecutionState

取得應用程式啟動前的執行狀態。
ServiceId

取得用於呼叫之服務的識別碼。
ServiceUserId

取得用於呼叫之服務的使用者識別碼。
SplashScreen

取得啟動顯示畫面物件，該物件提供從啟動顯示畫面轉換為啟動的應用程式的相關資訊。
Verb

取得要執行的動作。

適用於

另請參閱