Presentation APIs

Owned by BrightSign TechDocs
Last updated: Dec 18, 2023Version comment
15 min read

 

Presentation Entity

The Presentation entities has the following properties:

  • Id int:(read only) The identifier and primary key of the Presentation instance.

  • Name string: The user-defined name of the Presentation instance. This string value must be unique in the scope of the BrightSign Network account.

  • CreationDate DateTime:(read only) A UTC timestamp indicating when the presentation was created within the BrightSign Network.

  • LastModifiedDate DateTime:(read only) A UTC timestamp indicating the last time that presentation was modified.

  • AutorunVersion string:(read only) A string version of the device autorun referenced by the Presentation instance. A “(custom)” maker will be included with this string if the presentation references a custom autorun.

  • DeviceModel DeviceModel: The target device model of the Presentation instance represented by a DeviceModel enumeration value.

  • ScreenSettings ScreenSettings: The screen settings of a Presentation instance represented by a ScreenSettings structure.

  • Language PresentationLanguage: A PresentationLanguage enumeration that represents the target language of the presentation. This property currently has no effect on the operation of a presentation.

  • Zones List<PresentationZone>: A list of entity-relations inherited from the PresentationZone structure. The list references Content and ImageVideoDynamicPlaylist/AudioDynamicPlaylist instances used by the current Presentation instance.

  • Groups GroupInfo[]:(read only) An array of GroupInfo structures that represent parent Group instances for which the Presentation instance is scheduled.

DeviceModel Enumeration

The DeviceModel enumeration can contain the following values:

  • Unknown: This value is used by the server for presentations created in BrightAuthor.

  • TD1012

  • AU320

  • HD210

  • HD1010

  • LS322

  • LS422

  • HD920

  • HD970

  • HD220

  • HD1020

  • HD922

  • HD972

  • HD222

  • HD1022

  • XD230

  • XD1030

  • XD1230

  • XD232

  • XD1032

  • XD1132

  • 4K242

  • 4K1042

  • 4K1142

DeviceFamily Enumeration

The DeviceFamily enumeration can contain the following values:

  • Unknown

  • Monaco: HD210, HD1010, HD1010w, TD1012

  • Leopard: LS322, LS422

  • Panther: HD220, HD1020, AU320

  • Bobcat: HD222, HD1022

  • Cheetah: XD230, XD1030, XD1230

  • Lynx: XD232, XD1032, XD1132

  • Tiger: 4K242, 4K1042, 4K1142

  • Puma: HD970

PresentationLanguage Enumeration

The PresentationLanguage enumeration can contain the following values:

  • Unknown: This property is used by the server for presentations created in BrightAuthor.

  • English

  • French

  • Italian

  • German

  • Spanish

  • Swedish

ScreenSettings Structure

The ScreenSettings structure has the following properties:

  • VideoMode VideoMode: A VideoMode enumeration representing the resolution of a Presentation entity.

  • BackgroundColor string: The background color of a presentation entity. The color value is represented by the string “RGB: {R:XX}{G:XX}{B:XX)”, where “XX” is equivalent to a two-digit hexadecimal number (e.g. “RGB:4787C7”)

  • Orientation ScreenOrientation: A ScreenOrientation enumeration, which can contain the following values:

    • Landscape

    • Portrait

  • Connector ConnectorType: A ConnectorType enumeration, which can contain the following values:

    • VGA

    • HDMI

    • Component

  • Overscan ScreenOverscan: A ScreenOverscan enumeration, which can contain the following values:

    • NoOverscan

    • OverscanActionSafeArea

    • OverscanTitleSafeArea

PresentationZone Structure

The PresentationZone structure represents a single zone on the screen. Other zone structures are inherited from this structure. It has the following properties:

  • Id int: The identifier and primary key of the zone.

  • Name string: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.

  • X int: The x-axis coordinate specifying left side of the zone.

  • Y int: The y-axis coordinate specifying the top of the zone.

  • Width int: The horizontal size of the zone.

  • Height int: The vertical size of the zone.

  • Contents List<PresentationContent>: A list of PresentationContent entity-relations that represent the association between Content instances and the Presentation instance.

VideoOrImagesPresentationZone Structure

The VideoOrImagesPresentationZone structure is inherited from the PresentationZone structure. It may be used in either a full-screen or multi-zone It has the following properties:

  • Id int: The identifier and primary key of the zone.

  • IsFront bool: A flag indicating whether this zone is in front of another Video Only zone or Video or Images zone. 

  • Id int: The identifier and primary key of the zone.

  • Name string: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.

  • X int: The x-axis coordinate specifying left side of the zone.

  • Y int: The y-axis coordinate specifying the top of the zone.

  • Width int: The horizontal size of the zone.

  • Height int: The vertical size of the zone.

  • ViewMode ViewMode: A ViewMode enumeration specifying how a video will be modified if it doesn't match the resolution of the screen or zone.

  • ImageMode ImageMode: An ImageMode enumeration specifying how the image(s) will fill the zone.

  • AnalogOutput AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.

  • AnalogOutput2 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.

  • AnalogOutput3 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.

  • HDMIOutput HDMIOutputMode: An HDMIOutputMode enumerationspecifying the transmission setting of the HDMI® output on the device.

  • SPDIFOutput SPDIFOutputMode: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.

  • USBOutput USBOutputMode: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.

  • AudioMixing AudioMixingType: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.

  • VideoVolume int: The volume of the video file track, represented as an integer between 0 and 100.

  • AudioVolume int: The volume of the audio file track, represented as an integer between 0 and 100.

  • Contents List<PresentationContent>: A list of PresentationContent entity-relations that represent the association between Content instances and the Presentation instance.

ImagesPresentationZone Structure

The ImagesPresentationZone structure represents an Images zone that is part of a multi-zone presentation. It has the following values:

  • Id int: The identifier and primary key of the zone.

  • Name string: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.

  • X int: The x-axis coordinate specifying left side of the zone.

  • Y int: The y-axis coordinate specifying the top of the zone.

  • Width int: The horizontal size of the zone.

  • Height int: The vertical size of the zone.

  • ImageMode ImageMode: An ImageMode enumeration specifying how the image(s) will fill the zone.

  • Contents List<PresentationContent>: A list of PresentationContent entity-relations that represent the association between Content instances and the Presentation instance.

BackgroundImagePresentationZone Structure

The BackgroundImagePresentationZone structure represents a Background Image zone that is part of a multi-zone presentation. It has the following values:

  • Id int: The identifier and primary key of the zone.

  • Name string: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.

  • X int: The x-axis coordinate specifying left side of the zone.

  • Y int: The y-axis coordinate specifying the top of the zone.

  • Width int: The horizontal size of the zone.

  • Height int: The vertical size of the zone.

  • Contents List<PresentationContent>: A list of PresentationContent entity-relations that represent the association between Content instances and the Presentation instance.

VideoPresentationZone Structure

The VideoPresentationZone structure represents a Video Only zone that is part of a multi-zone presentation. It has the following values:

  • IsFront bool: A flag indicating whether this zone is in front of another Video Only zone or Video or Images zone.

  • ViewMode ViewMode: A ViewMode enumeration specifying how a video will be modified if it doesn't match the resolution of the screen or zone.

  • AnalogOutput AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.

  • AnalogOutput2 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.

  • AnalogOutput3 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.

  • HDMIOutput HDMIOutputMode: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.

  • SPDIFOutput SPDIFOutputMode: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.

  • USBOutput USBOutputMode: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.

  • AudioMixing AudioMixingType: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.

  • VideoVolume int: The volume of the video file track, represented as an integer between 0 and 100.

  • AudioVolume int: The volume of the audio file track, represented as an integer between 0 and 100.

AudioPresentationZone Structure

The AudioPresentationZone structure represents an Audio Only zone. It has the following properties.

  • AnalogOutput AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.

  • AnalogOutput2 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.

  • AnalogOutput3 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.

  • HDMIOutput HDMIOutputMode: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.

  • SPDIFOutput SPDIFOutputMode: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.

  • USBOutput USBOutputMode: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.

  • AudioMixing AudioMixingType: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.

  • AudioVolume int: The volume of the audio file track, represented as an integer between 0 and 100.

EnhancedAudioPresentationZone Structure

The EnhancedAudioPresentationZone structure represents an Enhanced Audio zone. It has the following properties:

  • FadeLength int: The duration of cross-fading between audio files, as well as the fade-in and fade-out durations at the beginning and end of the playlist.

  • AnalogOutput AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.

  • AnalogOutput2 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.

  • AnalogOutput3 AnalogOutputMode: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.

  • HDMIOutput HDMIOutputMode: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.

  • SPDIFOutput SPDIFOutputMode: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.

  • USBOutput USBOutputMode: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.

  • AudioMixing AudioMixingType: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.

  • AudioVolume int: The volume of the audio file track, represented as an integer between 0 and 100.

ViewMode Enumeration

The ViewMode enumeration represents how a video will be modified if it doesn't match the resolution of the screen or zone. It has the following values:

  • ScaleToFill

  • LetterboxedAndCentered

  • FillScreenAndCentered

ImageMode Enumeration

The ImageMode enumeration is used to specify how images will be modified if they don't match the resolution of the screen or zone. It can contain the following values:

  • CenterImage

  • ScaleToFit

  • ScaleToFillAndCrop

  • ScaleToFill

AnalogOutputMode Enumeration

The AnalogOutputMode enumeration represents the options for transmitting audio over the 3.5mm output on the device. It has the following values:

  • None

  • PCM

  • Multichannel

HDMIOutputMode Enumeration

The HDMIOutputMode enumeration represents the options for transmitting audio over the HDMI® output on the device. It has the following values:

  • None

  • PCM

  • PassThrough

SPDIFOutputMode Enumeration

The SPDIFOutputMode enumeration represents the options for outputting audio over the SPDIF port on the device. It has the following values:

  • None

  • PCM

  • PassThrough

USBOutputMode Enumeration

The USBOutputMode enumeration represents the options for transmitting audio over the USB port(s) on the device. It has the following values:

  • None

  • PCM

  • Surround

AudioMixingType Enumeration

The AudioMixingType enumeration represents the options for mixing all audio. This setting affects all video outputs. It can contain the following values:

  • Stereo

  • Left

  • Right

VideoMode Enumeration

The VideoMode enumeration represents the resolution of a Presentation entity. It can contain the following values:

This enumeration is set to Null for presentations created in BrightAuthor.

  • 4096x2160x24p 

  • 3840x2160x60p

  • 3840x2160x59.94p

  • 3840x2160x50p 

  • 3840x2160x30p 

  • 3840x2160x29.97p 

  • 3840x2160x25p 

  • 3840x2160x24p 

  • 1920x1200x60p 

  • 1920x1080x60p 

  • 1920x1080x59.94p 

  • 1920x1080x50p 

  • 1920x1080x30p 

  • 1920x1080x29.97p 

  • 1920x1080x25p 

  • 1920x1080x24p 

  • 1920x1080x60i 

  • 1920x1080x59.94i 

  • 1920x1080x50i 

  • 1680x1050x60p 

  • 1600x1200x60p 

  • 1440x900x75p 

  • 1440x900x60p 

  • 1400x1050x75p 

  • 1400x1050x60p 

  • 1360x768x60p 

  • 1280x1024x75p 

  • 1280x1024x60p 

  • 1280x960x60p 

  • 1280x800x75p 

  • 1280x800x60p 

  • 1280x768x60p 

  • 1280x720x60p 

  • 1280x720x59.94p 

  • 1280x720x50p 

  • 1024x768x75p 

  • 1024x768x60p 

  • 960x960x60p 

  • 800x600x75p 

  • 800x600x60p 

  • 720x576x50p 

  • 720x480x60p 

  • 720x480x59.94p 

  • 640x480x60p 

  • SECAM 

  • NTSC-COMPONENT 

  • PAL-COMPONENT 

  • NTSC-M 

  • NTSC-M-JPN 

  • PAL-I 

  • PAL-BG 

  • PAL-N 

  • PAL-NC 

  • PAL-M 

GroupInfo Structure

The GroupInfo structure is used to represent a parent Group instance for which a Presentation instance is scheduled. It has the following properties:

  • Id int: The identifier and primary key of the parent Group instance

  • Name string: The user-defined name of the parent Group instance

Presentation Management Web Methods

PagedList<Presentation> GetPresentations(string marker, int pageSize)

Retrieves the next page of the Presentation list, sorted by Name string. The returned list will contain no more items than the defined page size.

This method will not be able to initialize the DeviceModel enumeration, PresentationLanguage enumeration, or ScreenSettings structure if a target presentation was created in BrightAuthor. The server will return “unknown” and Null values instead.

Required Permissions

Presentation: View Presentations

Parameters

  • marker string: The Name string of the last Presentation instance on the previous page. If the value is Null, then the method will retrieve the first page.

  • pageSize int: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the pageSize int 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.

List<Presentation> GetSpecifiedPresentations(int[] presentationIds)

Retrieves a list of Presentation instances matching the specified identifiers. The results are organized by Name string. The identifiers of nonexistent Presentation instances will be ignored.

This method will not be able to initialize the DeviceModel enumeration, PresentationLanguage enumeration, or ScreenSettings structure if a target presentation was created in BrightAuthor. The server will return “unknown” and Null values instead.

Required Permissions

Presentation: View Presentations

Parameters

  • presentationIds int[]: An array of Id int values for the Presentation instances being requested. The number of requested items is limited to 100 by the server. Attempting to request more than the maximum allowed number of objects will cause an error, while passing an empty array will lead to an immediate empty response without an error.

PagedList<Presentation> FindPresentations(string namePattern, string marker, int pageSize)

Retrieves the next page of a Presentation list containing names matched with the specified pattern. The returned list is organized by Name string and may not contain more items than the defined page size.

Required Permissions

Presentation: View Presentations

Parameters

  • namePattern string: The exact Name string of the Presentation instance (or its wildcard-based pattern). Supported wildcards currently include “*”, “?”, and “[‘and’]”.

  • marker string: The Name string of the last Presentation instance on the previous page. If the value is Null, then the method will retrieve the first page.

  • pageSize int: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the pageSize int 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.

Presentation GetPresentation(int presentationId, bool loadAssets)

Retrieves a single Presentation instance with the specified Id int. This method returns Null if he Presentation instance with the specified identifier does not exist.

Required Permissions

Presentation: View Presentations

Parameters

  • presentationId int: The identifier and primary key of the Presentation instance to be retrieved.

  • loadContent bool: A flag specifying whether the method should also initialize and return a list of all Content instances used by the presentation. Setting this flag to True will return an error if the specified presentation was created in BrightAuthor.

Presentation GetPresentationByName(string name, bool loadContent)

Retrieves the Presentation instance with the specified Name string. This method returns Null if the Presentation instance with the specified name does not exist.

Required Permissions

Presentation: View Presentations

Parameters

  • name string: The user-defined Name of the Presentation instance to be retrieved.

  • loadContent bool: A flag specifying whether the method should also initialize and return a list of Content instances used by the presentation. Setting this flag to True will return an error if the specified presentation was created in BrightAuthor.

VideoMode[] GetSupportedVideoModes(DeviceModel deviceModel, ConnectorType connectorType)
Description

Lists screen resolutions supported on the specified device model using the specified connector type.

Required Permissions

None

Parameters

  • deviceModel DeviceModel: A DeviceModel enumeration indicating the model of BrightSign player to evaluate. Passing an unknown device model will result in a Null return value.

  • ConnectorType ConnectorType: A ConnectorType enumeration indicating the A/V connector on the model to evaluate.

bool CheckPresentationName(string name)

Determines whether the specified Presentation Name string is currently in use. This method returns True if a Presentation instance with the specified name currently exists.

Note that when using this method to check whether a Presentation can be uploaded, a False status may change between calling this method and calling CreatePresentation().

Required Permissions

Presentation: View Presentations

Parameters

  • name string: The Presentation Name value to be evaluated.

bool CheckPresentationUsage(int presentationId)

Determines whether the Presentation instance (specified by its primary key) is referenced by one or more Group instances. This method returns True if the Presentation instance has parent dependencies.

Note that when using this method to check whether a Presentation instance can be deleted, a False status may change in the time between calling this method and calling DeletePresentations().

Required Permissions

Presentation: View Presentations

Parameters

  • presentationId int: The identifier and primary key of the Presentation instance to evaluate. If a Presentation instance with the specified Id int does not exist, this method will return False without an error.

Presentation CreatePresentation(Presentation entity)

Creates a new Presentation instance and related server files using an initialized Presentation entity. If successful, this method will return the newly created object with all initialized properties. If an error occurs, the method will return a Null value.

Required Permissions

Presentation: Create Presentation – Content: Assign Content

Parameters

  • entity Presentation: A Presentation object instance with initialized Name string, DeviceModel DeviceModel, ScreenSettings ScreenSettings, and Zones List<PresentationZone> properties. The Zones list property should contain all required Content instances for the presentation. All other property values will be ignored. If this parameter is set to Null, then the server will immediately return Null without an error. The server will return a descriptive error if any of the following conditions occur:

    • The resolution in the ScreenSettings structure is not compatible with the specified device model (see the Output Resolutions FAQ for more details).

    • The DeviceModel enumeration value is “unknown”.

    • The PresentationLanguage enumeration value is “unknown”.

    • The length of the Presentation Name string is greater than 100 characters.

    • The Presentation Name string is already in use by another presentation in the account.

    • The AudioVolume  int or VideoVolume int of a zone structure is less than 0 or greater than 100.

    • The Zones list property of the Presentation instance does not contain at least one zone structure.

    • The number of zone structures (PresentationZone, ImagesZone, etc.) exceeds 50.

    • The boundaries of a zone structure—as defined by its X int, Y int, Width int, and Height int properties—exceeds the boundaries of the screen as defined by the VideoMode VideoMode property of the ScreenSettings structure.

    • The IsFront bool property is set to True for more than one VideoPresentationZone or VideoOrImagesPresentationZone structure.

    • The DisplayDuration TimeSpan of a PresentationContent entity-relation representing an image is less than 1 second or greater than 24 hours.

    • The DisplayDuration TimeSpan of a PresentationContent entity-relation representing a web page is less than 0 seconds or greater than 24 hours.

    • The FadeLength int value of an EnhancedAudioPresentationZone structure is greater than 100 or less than 0.

    • The specified device model does not have enough audio/video decoders to support the specified number of audio/video zone structures. 4Kx42, XDx32, and XDx30 models have two video and three audio decoders, while the HDx22, HDx20, and LSx22 models have one video and three audio decoders.

    • The Type ContentType of one or more Content instances is not supported by the associated zone structure(s).

    • The StateName string of one or more PresentationContent entity-relations exceeds 128 characters.

    • The StateName string of a PresentationContent entity-relation is not unique within the scope of the Presentation instance.

    • The number of Content instances exceeds the limit defined on the server.

    • The Id int of a zone structure is not unique within the scope of the Presentation instance.

    • The Name string of a zone structure is not unique within the scope of the Presentation instance.

    • The length of a zone Name string exceeds 50 characters.

    • The length of a PresentationZone Name string exceeds the limit defined on the server.

    • The specified AutorunVersion string is Invalid or is not supported.

Presentation UpdatePresentation(Presentation entity)

Updates the settings and Contents list of a Presentation instance (as well as related files in persistent storage). This method returns True only if the operation was completely successful. Otherwise, it returns False. Note that the same limitations apply to this method as to CreatePresentation().

Required Permissions

Presentation: Update Presentation, Add Content, Remove Content – Content: Assign Content, Unassign Content

Parameters

  • entity Presentation: A presentation object instance with a specified identifier, screen settings, etc. This method cannot be used to update a presentation name or target device model; the server will ignore the name or device model of a passed presentation entity. The instance must also have a Zones list property containing PresentationContent and DynamicPlaylistContent entity-relations. If this parameter is set to Null, then the server will immediately return False without an error. The server will return a descriptive error if any of the following conditions occur:

    • The resolution specified in the ScreenSettings structure is not compatible with the player specified in the DeviceModel enumeration (see the Output Resolutions FAQ for more details).

    • The PresentationLanguage enumeration value is “unknown”.

    • The Presentation Id int does not correspond to an existing Presentation instance.

    • The Id int of one or more zone structures does not correspond to a preexisting zone in the Presentation instance.

    • The length of the Presentation Name string exceeds the 256 character limit.

    • The Presentation Name string is already in use by an existing Presentation instance.

    • The length of a zone structure Name string exceeds the 50 character limit.

    • A specified zone structure Name string is not unique within the scope of the Presentation instance.

    • The AudioVolume int or VideoVolume int of a zone structure is less than 0 or greater than 100.

    • The FadeLength int value of an EnhancedAudioPresentationZone structure is greater than 100 or less than zero.

    • The boundaries of a zone structure—as defined by its X int, Y int, Width int, and Height int properties—exceeds the boundaries of the screen as defined by the [VideoMode] VideoMode property of the ScreenSettings structure.

    • The IsFront bool property is set to True for more than one VideoPresentationZone or VideoOrImagesPresentationZone structure.

    • The DisplayDuration TimeSpan of a PresentationContent entity-relation representing an image is less than 1 second or greater than 24 hours.

    • The DisplayDuration TimeSpan of a PresentationContent entity-relation representing a web page is less than 0 seconds or greater than 24 hours.

    • The specified device model does not have enough audio/video decoders to support the specified number of audio/video zone structures. 4Kx42, XDx32, and XDx30 models have two video and three audio decoders, while the HDx22, HDx20, and LSx22 models have one video and three audio decoders.

    • The Type ContentType of one or more Content instances is not supported by the associated zone structure(s).

    • The StateName string of one or more PresentationContent entity-relations exceeds 128 characters.

    • The StateName string of a PresentationContent entity-relation is not unique within the scope of the Presentation instance.

    • The Zones list property of the Presentation instance does not contain a PresentationZone structure.

    • The number of PresentationZone structures or Content instances exceeds the limit defined on the server.

    • The Name string of a PresentationZone structure is not unique within the scope of the Presentation instance.

    • The length of a PresentationZone Name string exceeds the limit set on the server side.

    • The specified AutorunVersion string is Invalid or is not supported.

bool UpdatePresentationZone(int presentationId, PresentationZone entity)

Updates the PresentationZone structure of an existing Presentation instance and its related service files in storage. This method returns True only if the operation is completely successful. Otherwise, it will return False.

Required Permissions

Presentation: Update Presentation, Add Content, Remove Content, Assign Content – Content: Unassign Content

Parameters

  • presentationId int: The identifier of the target Presentation instance. If this parameter is set to Null or set to a negative number, then the method will return False without an error. If the Id int is positive but does not correspond to an existing Presentation instance, the server will return a descriptive error.

  • entity PresentationZone: A PresentationZone structure with an initialized Id int and an updated set of properties, including a new Contents list. If this parameter is set to Null, then the method will immediately return Null without an error. The server will return a descriptive error if any of the following conditions occur:

    • The specified PresentationZone Id int does not match an existing PresentationZone structure.

    • The length of the PresentationZone Name string exceeds the limit defined on the server side.

    • The PresentationZone Name string is not unique within the scope of the account.

    • The AudioVolume int or VideoVolume int of a zone structure is less than 0 or greater than 100.

bool DeletePresentations(int[] presentationIds)

Deletes one or more Presentation instances and related service files in both the database and persistent storage. This method returns True only if the operation is completely successful. Otherwise, it will return False.

Required Permissions

Presentation: Delete Presentation

Parameters

  • presentationsIds int[]: An array of identifiers indicating the Presentation instances that should be deleted. The number of passed items is limited to 100 by the server. Attempting to delete more than the allowed number of objects will result in an error. An error will also be returned if an Id int does not correspond to an existing Presentation instance. Passing an empty array, or passing an array containing an identifier that does not match an existing Presentation instance, will lead to an immediate False response without an error.

ON THIS PAGE