ContactVideoCallActivatedEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Daten bereit, wenn eine App zum Videoanruf eines Kontakts aktiviert wird.
Javascript Dieser Typ wird als WebUIContactVideoCallActivatedEventArgs angezeigt.
public ref class ContactVideoCallActivatedEventArgs sealed : IActivatedEventArgs, IContactVideoCallActivatedEventArgs/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactVideoCallActivatedEventArgs final : IActivatedEventArgs, IContactVideoCallActivatedEventArgs[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactVideoCallActivatedEventArgs : IActivatedEventArgs, IContactVideoCallActivatedEventArgsPublic NotInheritable Class ContactVideoCallActivatedEventArgs
Implements IActivatedEventArgs, IContactVideoCallActivatedEventArgs- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
| Gerätefamilie |
Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (eingeführt in v1.0)
|
Beispiele
Hier sehen Sie ein Beispiel für den Code, den Sie zum Verarbeiten von Kontaktvideoanrufaktivierungen für 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.VideoCall)
{
IContactVideoCallActivatedEventArgs videoCallArgs = contactArgs as IContactVideoCallActivatedEventArgs;
//get contact display info
var contactName = videoCallArgs.Contact.DisplayName;
var contactThumbnail = videoCallArgs.Contact.Thumbnail;
if (videoCallArgs.ServiceId == "skype.com")
{
var userId = videoCallArgs.ServiceUserId;
//add video calling logic for Skype Ids
}
}
}
}
void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Contact)
{
auto contactArgs{ args.as<Windows::ApplicationModel::Activation::IContactActivatedEventArgs>() };
if (contactArgs.Verb() == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::VideoCall())
{
auto videoCallArgs{ contactArgs.as<Windows::ApplicationModel::Activation::ContactVideoCallActivatedEventArgs>() };
// Get contact display info.
auto contactName{ videoCallArgs.Contact().DisplayName() };
auto contactThumbnail{ videoCallArgs.Contact().Thumbnail() };
if (videoCallArgs.ServiceId() == L"skype.com")
{
auto userId = videoCallArgs.ServiceUserId();
//add messaging logic for Skype Ids
}
}
}
}
void App::OnActivated(IActivatedEventArgs^ args)
{
if (args->Kind == ActivationKind::Contact)
{
auto contactArgs = dynamic_cast<IContactActivatedEventArgs^>(args);
if (contactArgs->Verb == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::VideoCall)
{
auto videoCallArgs = dynamic_cast<ContactVideoCallActivatedEventArgs^>(contactArgs);
//get contact display info
auto contactName = videoCallArgs->Contact->DisplayName;
auto contactThumbnail = videoCallArgs->Contact->Thumbnail;
if (videoCallArgs->ServiceId == "skype.com")
{
auto userId = videoCallArgs->ServiceUserId;
//add video calling logic for Skype Ids
}
}
}
}
Hinweise
Windows 8.1 ermöglicht Benutzern das Videoanruf ihrer Kontakte über die Visitenkarte oder Windows Search-Benutzeroberfläche. Durch Die Implementierung des Vertrags zur Aktivierung von Kontaktvideoanrufen kann Windows Ihre App starten, um Videoanrufe für den Benutzer zu tätigen.
Zum Empfangen von Videoanrufaktivierungen muss sich Ihre App für die Erweiterungskategorie "windows.contact" im Manifest registrieren. Unter dieser Erweiterung müssen Sie ein "LaunchAction"-Element mit dem Attribut "Verb" einschließen, das gleich "videoCall" ist. Anschließend können Sie das "ServiceId"-Element angeben, um den Domänennamen des Diensts anzugeben, über den Ihre App Videoanrufe durchführen kann, z. B. "skype.com".
Wenn mehrere Apps für diesen Vertrag registriert sind, kann der Benutzer eine von ihnen als Standard für die Bearbeitung von Videoanrufen auswählen.
Hier sehen Sie 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="videoCall" DesiredView="useHalf">
<m2:ServiceId>skype.com</m2:ServiceId>
</m2:LaunchAction>
</m2:ContactLaunchActions>
</m2:Contact>
</m2:Extension>
Nachdem Sie sich in Ihrem Manifest registriert haben, kann Ihre App für den Vertrag für den Kontaktvideoanruf aktiviert werden. Wenn Ihre App aktiviert ist, können Sie die Ereignisinformationen verwenden, um die Aktivierung des Videoanrufs zu identifizieren und die Parameter zu extrahieren, mit denen Sie den Videoanruf für den Benutzer abschließen können.
Eigenschaften
| Contact |
Ruft den Kontakt für den Videoanruf ab. |
| Kind |
Ruft den Aktivierungstyp ab. |
| PreviousExecutionState |
Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde. |
| ServiceId |
Ruft den Bezeichner des Diensts ab, der für den Videoanruf verwendet wird. |
| ServiceUserId |
Ruft den Benutzerbezeichner des Diensts ab, der für den Videoanruf verwendet wird. |
| SplashScreen |
Ruft das Begrüßungsbildschirmobjekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt. |
| Verb |
Ruft die auszuführende Aktion ab. |