API de Windows Live Messenger Activity

published

1/28/2009 12:41:56 PM

by

Manuel Fernando

El API de Windows Live Messenger Activity está conformado por un pequeño set de objetos para implementar características personalizadas tales como sesiones de chat, transferencia de archivos y manejo de errores.

Este objeto permite enviar y recibir y nos permite interactuar con la ventana de chat de Windows Live Messenger.

Eventos del objeto Channel.

• OnAppClose: Este evento es invocado cuando se cierra el cliente de Windows Live Messenger.
• OnDataError: Este evento es invocado cuando una operación Channel.SendData no se completa exitosamente.
• OnDataReceived: Este evento es invocado cuando se reciben datos de la Activity Remota.
• OnFileProgress: Este evento es invocado sobre el progreso de la transferencia de un archivo. Para que éste evento sea invocado se requiere permisos en el atributo SendFile del archivo de configuración del Activity.
• OnFileReceived: Este evento es invocado cuando se recibe un archivo de la Activity Remota. Para que éste evento sea invocado se requiere permisos en los atributos SendFile y ActiveX del archivo de configuración del Activity.
• OnIMReceived: Este evento es invocado cuando se recibe un mensaje de la aplicación remota. Para que éste evento sea invocado se requiere permisos en los atributos ReceiveIM o ReplaceIM del archivo de configuración del Activity.
• OnRemoteAppClose: Este evento es invocado cuando se cierra el cliente remoto de Windows Live Messenger.
• OnRemoteAppLoaded: Este evento es invocado cuando la Activity Remota ha sido cargada y esta lista para recibir eventos.
• OnSendFileCancelled: Este evento es invocado cuando se cancela la transferencia de un archivo. Para que éste evento sea invocado se requiere permisos en el atributo SendFile del archivo de configuración del Activity.
• OnTypeChanged: Este evento es invocado cuando el tipo de comunicación entre los clientes ha cambiado.

Métodos del objeto Channel.

• EnterIM: Este método ingresa un mensaje la entrada de texto de la ventana de chat de Windows Live Messenger. Para que se pueda ingresar el mensaje se requiere permisos en el atributo SendIM del archivo de configuración del Activity.
• SendIM: Este método envía un mensaje instantáneo desde el Activity al cliente remoto. Para que se pueda enviar el mensaje se requiere permisos en el atributo SendIM del archivo de configuración del Activity.
• SendIMAsUser: Este método envía un mensaje instantáneo desde el Activity al cliente remoto a nombre del usuario. Para que se pueda enviar el mensaje se requiere permisos en el atributo ReplaceIM del archivo de configuración del Activity.
• SendData: Este método envía datos al Activity Remoto.
• SendFile: Este método envía un archivo desde el Activity. Para que se pueda enviar el archivo se requiere permisos en los atributos SendFile y ActiveX del archivo de configuración del Activity.
• CancelSendFile: Este método cancela la transferencia de un archivo en progreso. Para que se pueda cancelar la transferencia del archivo requiere permisos en el atributo SendFile del archivo de configuración del Activity.
• Initialize: Este método envía una señal al cliente Windows Live Messenger remoto indicando que el Activity está listo para recibir eventos.

Propiedades del objeto Channel.

• IM: Contiene un tipo string que representa el mensaje instantáneo que fue recibido y mostrado. Para poder leer esta propiedad se requiere de permisos en el atributo ReceiveIM. Para modificar el mensaje antes de que este sea mostrado se requiere permisos en el atributo ReplaceIM del archivo de configuración del Activity.
• Data: Contiene un tipo variant que representa los datos recibidos desde el Activity remoto.
• FileInfo: Contiene un objeto del tipo FileInfo que representa el archivo recibido. Para poder acceder a este objeto se requiere de permisos en el atributo SendFile del archivo de configuración del Activity.
• Type: Contiene un tipo ConnectionType que representa el tipo de conexión entre los dos clientes Windows Live Messenger.
• Error: Contiene un objeto del tipo Error que proporciona datos que podrían no ser entregados.

Propiedades del objeto FileInfo.

• Path: Ruta absoluta del archivo.
• Size: Retorna el tamaña del archivo.
• Progress: Retorna la cantidad de Bytes transferidos hasta el momento.
• Incoming: Esta propiedad retorna True si el archivo es entrante y False si es saliente.
• Status: Retorna el estado mediante la enumeración FileStatus.

Propiedades del objeto Error.

• Type: Retorna un valor del tipo long para identificar el tipo de error.
• Data: Retorna un tipo variant que contiene los datos de lo que fallo cuando el evento OnDataError fue lanzado.

Add a comment