LinphoneEvent

```
public interface LinphoneEvent
```
LinphoneEvent

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`acceptSubscription()` Accept an incoming subscription.
`void`	`addCustomHeader(String name, String value)` Add a custom header to an outgoing susbscription or publish.
`void`	`denySubscription(Reason reason)` Reject an incoming subscription.
`LinphoneCore`	`getCore()` Get a back pointer to the LinphoneCore object managing this LinphoneEvent.
`String`	`getCustomHeader(String name)` Obtain the value of a given header for an incoming subscription.
`ErrorInfo`	`getErrorInfo()` In case of error notified, returns the full error details.
`String`	`getEventName()` Get the event name as standardized by the event package RFC.
`Reason`	`getReason()` In the event where an error would be returned or notified relatively to this LinphoneEvent, returns a reason error code.
`SubscriptionDir`	`getSubscriptionDir()` Return subscription direction (incoming or outgoing).
`SubscriptionState`	`getSubscriptionState()` Get subscription state.
`Object`	`getUserContext()` Retrieve application context previously set by setUserContext().
`void`	`notify(LinphoneContent content)` Sends a NOTIFY request in the context of a LinphoneEvent created by an incoming subscription.
`void`	`sendPublish(LinphoneContent body)` Send a publish created by linphone_core_create_publish().
`void`	`sendSubscribe(LinphoneContent body)` Send a subscription previously created by linphone_core_create_subscribe().
`void`	`setUserContext(Object obj)` Assign an application context to the LinphoneEvent, for later use.
`void`	`terminate()` Terminate an outgoing or incoming subscription, depending on the way the LinphoneEvent was created.
`void`	`updatePublish(LinphoneContent content)` Update a Publish previously started with `LinphoneCore.publish(LinphoneAddress, String, int, LinphoneContent)`.
`void`	`updateSubscribe(LinphoneContent content)` Update a subscription initiated previously with `LinphoneCore.subscribe()`

- Method Detail
  - getEventName
```
String getEventName()
```
    Get the event name as standardized by the event package RFC.
    
    Returns:
    the event name.
  - getSubscriptionDir
```
SubscriptionDir getSubscriptionDir()
```
    Return subscription direction (incoming or outgoing). For publish initiated LinphoneEvent it is set to Invalid.
    
    Returns:
    the subscription direction.
  - getSubscriptionState
```
SubscriptionState getSubscriptionState()
```
    Get subscription state.
    
    Returns:
    the current subscription state.
  - acceptSubscription
```
void acceptSubscription()
```
    Accept an incoming subscription. After it is accepted the application can immediately start to send notifications with notify().
  - denySubscription
```
void denySubscription(Reason reason)
```
    Reject an incoming subscription.
    
    Parameters:
    reason - reason code for rejection.
  - notify
```
void notify(LinphoneContent content)
```
    Sends a NOTIFY request in the context of a LinphoneEvent created by an incoming subscription.
    
    Parameters:
    content - the data to be put in the notification.
  - updateSubscribe
```
void updateSubscribe(LinphoneContent content)
```
    Update a subscription initiated previously with LinphoneCore.subscribe()
    
    Parameters:
    content - the data to be put in the subscribe request.
  - updatePublish
```
void updatePublish(LinphoneContent content)
```
    Update a Publish previously started with LinphoneCore.publish(LinphoneAddress, String, int, LinphoneContent).
    
    Parameters:
    content - the data to be put in the publish request.
  - terminate
```
void terminate()
```
    Terminate an outgoing or incoming subscription, depending on the way the LinphoneEvent was created.
  - getReason
```
Reason getReason()
```
    In the event where an error would be returned or notified relatively to this LinphoneEvent, returns a reason error code.
    
    Returns:
  - getErrorInfo
```
ErrorInfo getErrorInfo()
```
    In case of error notified, returns the full error details.
    
    Returns:
    an ErrorInfo.
  - setUserContext
```
void setUserContext(Object obj)
```
    Assign an application context to the LinphoneEvent, for later use.
    
    Parameters:
    obj -
  - getUserContext
```
Object getUserContext()
```
    Retrieve application context previously set by setUserContext().
    
    Returns:
  - addCustomHeader
```
void addCustomHeader(String name,
                   String value)
```
    Add a custom header to an outgoing susbscription or publish.
    
    Parameters:
    name - header's name
    value - the header's value.
  - getCustomHeader
```
String getCustomHeader(String name)
```
    Obtain the value of a given header for an incoming subscription.
    
    Parameters:
    name - header's name
    
    Returns:
    the header's value or NULL if such header doesn't exist.
  - sendSubscribe
```
void sendSubscribe(LinphoneContent body)
```
    Send a subscription previously created by linphone_core_create_subscribe().
    
    Parameters:
    body - optional content to attach with the subscription.
  - sendPublish
```
void sendPublish(LinphoneContent body)
```
    Send a publish created by linphone_core_create_publish().
    
    Parameters:
    body - the new data to be published
  - getCore
```
LinphoneCore getCore()
```
    Get a back pointer to the LinphoneCore object managing this LinphoneEvent.
    
    Returns:

Interface LinphoneEvent

Method Summary

Method Detail

getEventName

getSubscriptionDir

getSubscriptionState

acceptSubscription

denySubscription

notify

updateSubscribe

updatePublish

terminate

getReason

getErrorInfo

setUserContext

getUserContext

addCustomHeader

getCustomHeader

sendSubscribe

sendPublish

getCore