68 lines
2.2 KiB
XML
68 lines
2.2 KiB
XML
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||
|
|
|
||
|
|
<node>
|
||
|
|
<!-- org.sigxcpu.Feedback
|
||
|
|
@short_description: haptic/audio/visual feedback interface
|
||
|
|
|
||
|
|
This D-Bus interface is used to get the current feedback theme
|
||
|
|
and to give feedback on events.
|
||
|
|
-->
|
||
|
|
<interface name="org.sigxcpu.Feedback">
|
||
|
|
<!--
|
||
|
|
Profile: The currently used profile.
|
||
|
|
|
||
|
|
The currently used feedback profile name. Applications should
|
||
|
|
usually not change this value.
|
||
|
|
-->
|
||
|
|
<property name="Profile" type="s" access="readwrite" />
|
||
|
|
|
||
|
|
<!--
|
||
|
|
TriggerFeedback:
|
||
|
|
@app_id: The application id usually in "reverse DNS" format
|
||
|
|
@event: The event name from the Event naming spec
|
||
|
|
@hints: Additional hints (e.g. to prefer haptic feedback over audio feedback on button press events)
|
||
|
|
@timeout: When the feedbacks for this event should end latest in seconds. The special values '-1' (just run each feedback once) and '0' (endless loop) are also supported.
|
||
|
|
@id: Event id for future reference
|
||
|
|
|
||
|
|
Give user feedback for an event by triggering feedbacks
|
||
|
|
defined in the daemon. The method call returns an event id
|
||
|
|
that can be used later on to e.g. cancel the triggered
|
||
|
|
feedbacks early.
|
||
|
|
|
||
|
|
Depending on the event, theme and profile several forms of
|
||
|
|
feedback will be triggered such as an audio ring tone and a
|
||
|
|
haptic motor.
|
||
|
|
-->
|
||
|
|
<method name="TriggerFeedback">
|
||
|
|
<arg direction="in" name="app_id" type="s"/>
|
||
|
|
<arg direction="in" name="event" type="s"/>
|
||
|
|
<arg direction="in" name="hints" type="a{sv}"/>
|
||
|
|
<arg direction="in" name="timeout" type="i"/>
|
||
|
|
<arg direction="out" name="id" type="u"/>
|
||
|
|
</method>
|
||
|
|
|
||
|
|
<!--
|
||
|
|
EndFeedback:
|
||
|
|
@id: The id of the event
|
||
|
|
|
||
|
|
End all feedbacks triggered by the event with the given id.
|
||
|
|
-->
|
||
|
|
<method name="EndFeedback">
|
||
|
|
<arg direction="in" name="id" type="u"/>
|
||
|
|
</method>
|
||
|
|
|
||
|
|
<!--
|
||
|
|
FeedbackEnded:
|
||
|
|
@id: The id of the event
|
||
|
|
@reason: The reason why feedback was ended (currently unused).
|
||
|
|
|
||
|
|
Emitted when all feedbacks for an event have ended.
|
||
|
|
-->
|
||
|
|
<signal name="FeedbackEnded">
|
||
|
|
<arg name="id" type="u"/>
|
||
|
|
<arg name="reason" type="u"/>
|
||
|
|
</signal>
|
||
|
|
</interface>
|
||
|
|
|
||
|
|
</node>
|