InvitationReplyRequest
Replies to an invitation received by the current user.
new InvitationReplyRequest(invitation, invitationReply[, params])
Creates a new InvitationReplyRequest instance. The instance must be passed to the SmartFox.send() method for the request to be executed.
Users who receive an invitation sent by means of the InviteUsersRequest request can either accept or refuse it using this request. The reply causes an invitationReply event to be dispatched to the inviter; if a reply is not sent, or it is sent after the invitation expiration, the system will react as if the invitation was refused.
If an error occurs while the reply is delivered to the inviter user (for example the invitation is already expired), an invitationReplyError event is returned to the current user.
Example
This example receives an invitation and accepts it automatically; in a real case scenario, the application interface usually allows the user choosing to accept or refuse the invitation, or even ignore it.
function someMethod()
{
sfs.addEventListener(SFS2X.SFSEvent.INVITATION, onInvitationReceived, this);
sfs.addEventListener(SFS2X.SFSEvent.INVITATION_REPLY_ERROR, onInvitationReplyError, this);
}
function onInvitationReceived(evtParams)
{
// Let's accept this invitation
sfs.send(new SFS2X.InvitationReplyRequest(evtParams.invitation, SFS2X.InvitationReply.ACCEPT));
}
function onInvitationReplyError(evtParams)
{
console.log("Failed to reply to invitation due to the following problem: " + evtParams.errorMessage);
}Parameters
| Name | Type | Optional | Description |
|---|---|---|---|
|
invitation |
|
|
An instance of the SFSInvitation class containing the invitation details (inviter, custom parameters, etc). |
|
invitationReply |
|
|
The answer to be sent to the inviter, among those available as constants in the InvitationReply class. |
|
params |
|
Yes |
A SFSObject containing custom parameters to be returned to the inviter together with the reply (for example a message describing the reason of refusal). Defaults to |