ContactCallActivatedEventArgs-Klasse

ContactCallActivatedEventArgs Class

Stellt Daten bereit, wenn eine Anwendung aktiviert wird, um einen Kontakt anzurufen.

JavaScript:  Dieser Typ wird als WebUIContactCallActivatedEventArgs angezeigt.

Syntax


public sealed class ContactCallActivatedEventArgs : IContactCallActivatedEventArgs,
    IContactActivatedEventArgs,
    IActivatedEventArgs

Attribute

[MarshalingBehavior(Agile)]
[Version(0x06030000)]

Member

ContactCallActivatedEventArgsKlasse hat diese Membertypen:

Methoden

The ContactCallActivatedEventArgs Klasse erbt Methoden von Object Klasse.

Eigenschaften

Der ContactCallActivatedEventArgsKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Contact

SchreibgeschütztGets the contact for the call.

Kind

SchreibgeschütztGets the activation type.

PreviousExecutionState

SchreibgeschütztGets the execution state of the app before it was activated.

ServiceId

SchreibgeschütztGets the identifier of the service used for the call.

ServiceUserId

SchreibgeschütztGets the user identifier of the service used for the call.

SplashScreen

SchreibgeschütztGets the splash screen object, which provides information about the transition from the splash screen to the activated app.

Verb

SchreibgeschütztGets the action to be performed.

 

Hinweise

Unter Windows 8.1 können Benutzer ihre Kontakte von der Visitenkarte oder der Windows Search-Benutzeroberfläche aus anrufen. Durch das Implementieren des Vertrags zur Aktivierung von Kontaktanrufen kann Windows die App starten, um für den Benutzer Anrufe durchzuführen.

Um Anfrufaktivierungen zu empfangen, muss die App für die Erweiterungskategorie "windows.contact" im Manifest registriert werden. Unter dieser Erweiterung müssen Sie ein "LaunchAction"-Element mit dem "Verb"-Attribut einschließen, das "call" entspricht. Sie können das Element "ServiceId" dann angeben, um den unterstützten Anruftyp anzugeben. Wenn die App beispielsweise Standard PSTN-Aufrufe behandelt, können Sie eine "ServiceId" von "telephone" angeben. Wenn Ihre App Aufrufe über einen dateibasierten Webdienst wie Skype behandelt, können Sie den Domänennamen dieses Diensts angeben, beispielsweise "skype.com".

Wenn mehrere Apps für den Vertrag registriert wurden, kann der Benutzer eine davon als Standard für die Verwaltung der Anrufe auswählen.

Hinweis  Um einem Benutzer zu ermöglichen, Ihre App als Standard-App für Anrufe an Festnetznummern festzulegen, muss Ihre App auch das "tel"-URI-Schema unterstützen.

Ein Beispiel für die Manifestregistrierung:



<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>


Nach der Registrierung im Manifest kann die App für den Vertrag für den Kontaktaufruf aktiviert werden. Wenn Ihre App aktiviert ist, können Sie mit den Ereignisinformationen die Aufrufsaktivierung identifizieren und die Parameter extrahieren, mit denen Sie den Aufruf für den Benutzer abschließen können.

Beispiele

Im Folgenden ein Beispiel des Codes, den Sie zum behandeln von Kontaktaufrufsaktivierungen für PSTN-Zahlen und Skype-IDs benötigen:


protected override void OnActivated(IActivatedEventArgs args)
{
    if (args.Kind == ActivationKind.Contact)
    {
        var contactArgs = args as IContactActivatedEventArgs;
        if (contactArgs.Verb == Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.Call)
        { 
            IContactCallActivatedEventArgs callArgs = contactArgs as IContactCallActivatedEventArgs;

     //get contact display info
     var contactName = callArgs.Contact.DisplayName;
            var contactThumbnail = callArgs.Contact.Thumbnail;

            if (callArgs.ServiceId == "telephone")
            {
                var phoneNumber = callArgs.ServiceUserId;
                //add calling logic for PSTN numbers
            }
            else if (callArgs.ServiceId == "skype.com")
            {
                var userId = callArgs.ServiceUserId;
                //add calling logic for Skype Ids
            }
        }
                
    }
}


Anforderungen

Mindestens unterstützter Client

Windows 8.1 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 R2 [Nur Windows Store-Apps]

Namespace

Windows.ApplicationModel.Activation
Windows::ApplicationModel::Activation [C++]

Metadaten

Windows.winmd

Siehe auch

Object
IContactCallActivatedEventArgs
IContactActivatedEventArgs
IActivatedEventArgs
Beispiel für die Behandlung von Kontaktaktionen

 

 

Anzeigen:
© 2018 Microsoft