Session

Object Hierarchy:

Description:

[ CCode ( type_id = "mks_session_get_type ()" ) ]
public sealed class Session : Object, AsyncInitable, Initable

Session connected to a QEMU VM

The `MksSession` represents a connection to a QEMU VM instance. It contains devices such as the mouse, keyboard, and screen which can be used with GTK.

You may monitor [property@Mks.Session:devices] using [signal@Gio.ListModel:MksSession:items-changed] to be notified of changes to available devices in the session.

Connecting To QEMU

To use `MksSession`, you should create your QEMU instance using `dbus` for the various devices that support it. You'll need to provide your P2P D-Bus address when connecting to QEMU.

Using the same [class@Gio.DBusConnection], create a `MksSession` with [func@Mks.Session.new_for_connection]. The `MksSession` instance will negotiate with the peer to determine what devices are available and expose them via the [property@Mks.Session:devices] [ iface@Gio.ListModel].

Creating Widgets

You can create a new widget to embed in your application by calling [method@Mks.Session.ref_screen] and set the screen for the [ class@Mks.Display] with [method@Mks.Display.set_screen].

Namespace: Mks

Package: libmks-1

Content:

Properties:

public DBusConnection connection { get; construct; }
The [class@Gio.
public ListModel devices { get; }
A [iface@Gio.
public string name { get; }
The VM name as specified by the QEMU instance.
public string uuid { get; }
The VM unique identifier specified by the QEMU instance.

Creation methods:

protected Session ()
public async Session.for_connection (DBusConnection connection, int io_priority, Cancellable? cancellable) throws Error
Creates a Session which communicates using connection.
public Session.for_connection_sync (DBusConnection connection, Cancellable? cancellable = null) throws Error
Synchronously creates a new Session instance.

Methods:

public unowned DBusConnection? get_connection ()
Gets the DBus connection used for this session.
public unowned ListModel get_devices ()
Gets a ListModel of devices connected to the session.
public unowned string get_name ()
Gets the name of the VM.
public unowned string get_uuid ()
Gets the unique identifier of the VM.
public Screen? ref_screen ()
Gets the main screen for the session.

Inherited Members:

All known members inherited from class GLib.Object

All known members inherited from interface GLib.AsyncInitable

new_valist_async

newv_async

All known members inherited from interface GLib.Initable

@new
init

new_valist

newv