/// <summary> /// Invoked when a contact has published music information. /// </summary> /// <param name="jid">The JID of the XMPP entity that published the tune /// information.</param> /// <param name="item">The 'item' Xml element of the pubsub publish /// event.</param> private void onTune(Jid jid, XmlElement item) { if (item == null || item["tune"] == null) { return; } var tune = item["tune"]; if (tune.IsEmpty) { // Raise the 'Tune' event without information. Tune.Raise(this, new TuneEventArgs(jid)); return; } // Parse 'tune' element. int length = 0; if (tune["length"] != null) { length = int.Parse(tune["length"].InnerText); } int rating = 0; if (tune["rating"] != null) { rating = int.Parse(tune["rating"].InnerText); } TuneInformation info = new TuneInformation( GetField(tune, "title"), GetField(tune, "artist"), GetField(tune, "track"), length, rating, GetField(tune, "source"), GetField(tune, "uri")); // Raise the 'Tune' event. Tune.Raise(this, new TuneEventArgs(jid, info)); }
/// <summary> /// Publishes the specified music information to contacts on the user's /// roster. /// </summary> /// <param name="tune">The tune information to publish.</param> /// <exception cref="ArgumentNullException">The tune parameter is /// null.</exception> /// <exception cref="NotSupportedException">The server does not support the /// 'Personal Eventing Protocol' extension.</exception> /// <exception cref="XmppErrorException">The server returned an XMPP error code. /// Use the Error property of the XmppErrorException to obtain the specific /// error condition.</exception> /// <exception cref="XmppException">The server returned invalid data or another /// unspecified XMPP error occurred.</exception> /// <exception cref="InvalidOperationException">The XmppClient instance is not /// connected to a remote host, or the XmppClient instance has not authenticated with /// the XMPP server.</exception> /// <exception cref="ObjectDisposedException">The XmppClient object has been /// disposed.</exception> /// <include file='Examples.xml' path='S22/Xmpp/Client/XmppClient[@name="SetTune"]/*'/> public void SetTune(TuneInformation tune) { AssertValid(); userTune.Publish(tune); }
/// <summary> /// Initializes a new instance of the TuneEventArgs class. /// </summary> /// <param name="jid">The JID of the XMPP entity that published the /// tune information.</param> /// <param name="information">The tune information to include as part of /// the event.</param> /// <exception cref="ArgumentNullException">The jid parameter is /// null.</exception> public TuneEventArgs(Jid jid, TuneInformation information = null) { jid.ThrowIfNull("jid"); Jid = jid; Information = information; }
/// <summary> /// Initializes a new instance of the TuneEventArgs class. /// </summary> /// <param name="jid">The JID of the XMPP entity that published the /// tune information.</param> /// <param name="information">The tune information to include as part of /// the event.</param> /// <exception cref="ArgumentNullException">The jid parameter is /// null.</exception> public TuneEventArgs(Jid jid, TuneInformation information = null) { jid.ThrowIfNull("jid"); Jid = jid; Information = information; }
/// <summary> /// Publishes the specified music information to contacts on the user's /// roster. /// </summary> /// <param name="tune">The tune information to publish.</param> /// <exception cref="ArgumentNullException">The tune parameter is /// null.</exception> /// <exception cref="NotSupportedException">The server does not support the /// 'Personal Eventing Protocol' extension.</exception> /// <exception cref="XmppErrorException">The server returned an XMPP error code. /// Use the Error property of the XmppErrorException to obtain the specific /// error condition.</exception> /// <exception cref="XmppException">The server returned invalid data or another /// unspecified XMPP error occurred.</exception> /// <remarks>Publishing no information (i.e. calling Publish without any parameters /// is considered a "stop command" to disable publishing).</remarks> public void Publish(TuneInformation tune) { tune.ThrowIfNull("tune"); Publish(tune.Title, tune.Artist, tune.Track, tune.Length, tune.Rating, tune.Source, tune.Uri); }
/// <summary> /// Invoked when a contact has published music information. /// </summary> /// <param name="jid">The JID of the XMPP entity that published the tune /// information.</param> /// <param name="item">The 'item' Xml element of the pubsub publish /// event.</param> private void OnTune(Jid jid, XmlElement item) { if (item == null || item["tune"] == null) return; var tune = item["tune"]; if (tune.IsEmpty) { // Raise the 'Tune' event without information. Tune.Raise(this, new TuneEventArgs(jid)); return; } // Parse 'tune' element. int length = 0; if (tune["length"] != null) length = Int32.Parse(tune["length"].InnerText); int rating = 0; if (tune["rating"] != null) rating = Int32.Parse(tune["rating"].InnerText); TuneInformation info = new TuneInformation( GetField(tune, "title"), GetField(tune, "artist"), GetField(tune, "track"), length, rating, GetField(tune, "source"), GetField(tune, "uri")); // Raise the 'Tune' event. Tune.Raise(this, new TuneEventArgs(jid, info)); }
/// <summary> /// Publishes the specified music information to contacts on the user's /// roster. /// </summary> /// <param name="tune">The tune information to publish.</param> /// <exception cref="ArgumentNullException">The tune parameter is /// null.</exception> /// <exception cref="NotSupportedException">The server does not support the /// 'Personal Eventing Protocol' extension.</exception> /// <exception cref="XmppErrorException">The server returned an XMPP error code. /// Use the Error property of the XmppErrorException to obtain the specific /// error condition.</exception> /// <exception cref="XmppException">The server returned invalid data or another /// unspecified XMPP error occurred.</exception> /// <remarks>Publishing no information (i.e. calling Publish without any parameters /// is considered a "stop command" to disable publishing).</remarks> public void Publish(TuneInformation tune) { tune.ThrowIfNull("tune"); Publish(tune.Title, tune.Artist, tune.Track, tune.Length, tune.Rating, tune.Source, tune.Uri); }
/// <summary> /// Publishes the specified music information to contacts on the user's /// roster. /// </summary> /// <param name="tune">The tune information to publish.</param> /// <exception cref="ArgumentNullException">The tune parameter is /// null.</exception> /// <exception cref="NotSupportedException">The server does not support the /// 'Personal Eventing Protocol' extension.</exception> /// <exception cref="XmppErrorException">The server returned an XMPP error code. /// Use the Error property of the XmppErrorException to obtain the specific /// error condition.</exception> /// <exception cref="XmppException">The server returned invalid data or another /// unspecified XMPP error occurred.</exception> /// <remarks>Publishing no information (i.e. calling Publish without any parameters /// is considered a "stop command" to disable publishing).</remarks> public async Task Publish(TuneInformation tune) { tune.ThrowIfNull("tune"); await Publish(tune.Title, tune.Artist, tune.Track, tune.Length, tune.Rating, tune.Source, tune.Uri); }