ON THIS PAGE
This section outlines management of Remote Snapshot images. To modify the Remote Snapshot settings on a player, use the UpdateDeviceRemoteSnapshotSettings()
Device Management method.
DeviceScreenShot Structure
The DeviceScreenShot structure represents a single Remote Snapshot image of a presentation display. It has the following values:
[int] Id
:(read only) The identifier and primary key of the Remote Snapshot image.[string] GroupName
:(read only) The Name of the Group entity that the player belonged to when it posted the Remote Snapshot image to the server. Note that this Name can be different from the Group entity to which the player currently belongs.[string] PresentationName
:(read only) The Name of the Presentation entity that the player was running when it posted the Remote Snapshot image to the server.[DateTime] Timestamp
:(read only) A UTC timestamp indicating when the player posted the Remote Snapshot image to the server.[short] Width
:(read only) The width of the image (in pixels).[short] Height
:(read only) The height of the image (in pixels).[string] FilePath
:(read only) An external URL of the image file in the persistent storage.[int] FileSize
:(read only) The size of the image file (in bytes)
Remote Snapshot Management Web Methods
PagedList<DeviceScreenShot> GetDeviceScreenShots(int deviceId, string marker, int pageSize)
Retrieves the next page of the DeviceScreenShot list, sorted by timestamp. This method will return no more items than the defined page size.
Required Permissions
Device: View Device Screenshots
Parameters
[int] deviceId
: The identifier and primary key of the device posting the requested screenshots. The method returns Null if a Device instance with the specified identifier does not exist.[string] marker
: The timestamp of the last DeviceScreenShot instance on the previous page. If the value is Null, then the method will retrieve the first page.[int] pageSize
: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the[int] pageSize
limit, the returned list will indicate that it is truncated. If the integer is not positive, then the method will return the maximum allowed number of objects. Attempting to request more objects than is allowed will lead to the same result, but without an error.