Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

ON THIS PAGE

Presentation Entity

The Presentation entities has the following properties:

  • [int] Id:(read only) The identifier and primary key of the Presentation instance.
  • [string] Name: The user-defined name of the Presentation instance. This string value must be unique in the scope of the BrightSign Network account.
  • [DateTime] CreationDate:(read only) A UTC timestamp indicating when the presentation was created within the BrightSign Network.
  • [DateTime] LastModifiedDate:(read only) A UTC timestamp indicating the last time that presentation was modified.
  • [string] AutorunVersion:(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.
  • [PresentationLanguage] Language: A PresentationLanguage enumeration that represents the target language of the presentation. This property currently has no effect on the operation of a presentation.
  • [List<PresentationZone>] Zones: A list of entity-relations inherited from the PresentationZone structure. The list references Content and ImageVideoDynamicPlaylist/AudioDynamicPlaylist instances used by the current Presentation instance.
  • [GroupInfo[]] Groups:(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.
  • [string] BackgroundColor: 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”)
  • [ScreenOrientation] Orientation: A ScreenOrientation enumeration, which can contain the following values:
    • Landscape
    • Portrait
  • [ConnectorType] Connector: A ConnectorType enumeration, which can contain the following values:
    • VGA
    • HDMI
    • Component
  • [ScreenOverscan] Overscan: 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:

  • [int] Id: The identifier and primary key of the zone.
  • [string] Name: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
  • [int] X: The x-axis coordinate specifying left side of the zone.
  • [int] Y: The y-axis coordinate specifying the top of the zone.
  • [int] Width: The horizontal size of the zone.
  • [int] Height: The vertical size of the zone.
  • [List<PresentationContent>] Contents: 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:

  • [int] Id: The identifier and primary key of the zone.
  • [bool] IsFront: A flag indicating whether this zone is in front of another Video Only zone or Video or Images zone. 
  • [int] Id: The identifier and primary key of the zone.
  • [string] Name: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
  • [int] X: The x-axis coordinate specifying left side of the zone.
  • [int] Y: The y-axis coordinate specifying the top of the zone.
  • [int] Width: The horizontal size of the zone.
  • [int] Height: 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.
  • [AnalogOutputMode] AnalogOutput: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput2: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput3: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
  • [HDMIOutputMode] HDMIOutput: An HDMIOutputMode enumerationspecifying the transmission setting of the HDMI output on the device.
  • [SPDIFOutputMode] SPDIFOutput: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
  • [USBOutputMode] USBOutput: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
  • [AudioMixingType] AudioMixing: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
  • [int] VideoVolume: The volume of the video file track, represented as an integer between 0 and 100.
  • [int] AudioVolume: The volume of the audio file track, represented as an integer between 0 and 100.
  • [List<PresentationContent>] Contents: 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:

  • [int] Id: The identifier and primary key of the zone.
  • [string] Name: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
  • [int] X: The x-axis coordinate specifying left side of the zone.
  • [int] Y: The y-axis coordinate specifying the top of the zone.
  • [int] Width: The horizontal size of the zone.
  • [int] Height: The vertical size of the zone.
  • [ImageMode] ImageMode: An ImageMode enumeration specifying how the image(s) will fill the zone.
  • [List<PresentationContent>] Contents: 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:

  • [int] Id: The identifier and primary key of the zone.
  • [string] Name: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
  • [int] X: The x-axis coordinate specifying left side of the zone.
  • [int] Y: The y-axis coordinate specifying the top of the zone.
  • [int] Width: The horizontal size of the zone.
  • [int] Height: The vertical size of the zone.
  • [List<PresentationContent>] Contents: 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:

  • [bool] IsFront: 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.
  • [AnalogOutputMode] AnalogOutput: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput2: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput3: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
  • [HDMIOutputMode] HDMIOutput: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.
  • [SPDIFOutputMode] SPDIFOutput: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
  • [USBOutputMode] USBOutput: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
  • [AudioMixingType] AudioMixing: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
  • [int] VideoVolume: The volume of the video file track, represented as an integer between 0 and 100.
  • [int] AudioVolume: 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.

  • [AnalogOutputMode] AnalogOutput: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput2: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput3: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
  • [HDMIOutputMode] HDMIOutput: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.
  • [SPDIFOutputMode] SPDIFOutput: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
  • [USBOutputMode] USBOutput: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
  • [AudioMixingType] AudioMixing: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
  • [int] AudioVolume: 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:

  • [int] FadeLength: 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.
  • [AnalogOutputMode] AnalogOutput: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput2: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
  • [AnalogOutputMode] AnalogOutput3: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
  • [HDMIOutputMode] HDMIOutput: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.
  • [SPDIFOutputMode] SPDIFOutput: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
  • [USBOutputMode] USBOutput: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
  • [AudioMixingType] AudioMixing: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
  • [int] AudioVolume: 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:

Note

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:

  • [int] Id: The identifier and primary key of the parent Group instance
  • [string] Name: 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 [string] Name. The returned list will contain no more items than the defined page size.

Note

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
  • [string] marker: The [string] Name of the last Presentation 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.
List<Presentation> GetSpecifiedPresentations(int[] presentationIds)

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

Note

 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
  • [int[]] presentationIds: An array of [int] Id 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 [string] Name and may not contain more items than the defined page size.

Note

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
  • [string] namePattern: The exact [string] Name of the Presentation instance (or its wildcard-based pattern). Supported wildcards currently include “*”, “?”, and “[‘and’]”.
  • [string] marker: The [string] Name of the last Presentation 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.
Presentation GetPresentation(int presentationId, bool loadAssets)

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

Note

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
  • [int] presentationId: The identifier and primary key of the Presentation instance to be retrieved.
  • [bool] loadContent: 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 [string] Name. This method returns Null if the Presentation instance with the specified name does not exist.

Note

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
  • [string] name: The user-defined Name of the Presentation instance to be retrieved.
  • [bool] loadContent: 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 [string] Name 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
  • [string] name: 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
  • [int] presentationId: The identifier and primary key of the Presentation instance to evaluate. If a Presentation instance with the specified [int] Id 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
  • [Presentation] entity: A Presentation object instance with initialized [string] Name, [DeviceModel] DeviceModel, [ScreenSettings] ScreenSettings, and [List<PresentationZone>] Zones 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 [string] Name is greater than 100 characters.
    • The Presentation [string] Name is already in use by another presentation in the account.
    • The [int] AudioVolume or [int] VideoVolume 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 [int] X, [int] Y, [int] Width, and [int] Height properties—exceeds the boundaries of the screen as defined by the [VideoMode] VideoMode property of the ScreenSettings structure.
    • The [bool] IsFront property is set to True for more than one VideoPresentationZone or VideoOrImagesPresentationZone structure.
    • The [TimeSpan] DisplayDuration of a PresentationContent entity-relation representing an image is less than 1 second or greater than 24 hours.
    • The [TimeSpan] DisplayDuration of a PresentationContent entity-relation representing a web page is less than 0 seconds or greater than 24 hours.
    • The [int] FadeLength 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 [ContentType] Type of one or more Content instances is not supported by the associated zone structure(s).
    • The [string] StateName of one or more PresentationContent entity-relations exceeds 128 characters.
    • The [string] StateName 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 [int] Id of a zone structure is not unique within the scope of the Presentation instance.
    • The [string] Name of a zone structure is not unique within the scope of the Presentation instance.
    • The length of a zone [string] Name exceeds 50 characters.
    • The length of a PresentationZone [string] Name exceeds the limit defined on the server.
    • The specified [string] AutorunVersion 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().

Note

This method cannot be used to update a presentation created in BrightAuthor. The server will return an error immediately if this is attempted.

Required Permissions

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

Parameters
  • [Presentation] entity: 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 [int] Id does not correspond to an existing Presentation instance.
    • The [int] Id of one or more zone structures does not correspond to a preexisting zone in the Presentation instance.
    • The length of the Presentation [string] Name exceeds the 256 character limit.
    • The Presentation [string] Name is already in use by an existing Presentation instance.
    • The length of a zone structure [string] Name exceeds the 50 character limit.
    • A specified zone structure [string] Name is not unique within the scope of the Presentation instance.
    • The [int] AudioVolume or [int] VideoVolume of a zone structure is less than 0 or greater than 100.
    • The [int] FadeLength value of an EnhancedAudioPresentationZone structure is greater than 100 or less than zero.
    • The boundaries of a zone structure—as defined by its [int] X, [int] Y, [int] Width, and [int] Height properties—exceeds the boundaries of the screen as defined by the [VideoMode] VideoMode property of the ScreenSettings structure.
    • The [bool] IsFront property is set to True for more than one VideoPresentationZone or VideoOrImagesPresentationZone structure.
    • The [TimeSpan] DisplayDuration of a PresentationContent entity-relation representing an image is less than 1 second or greater than 24 hours.
    • The [TimeSpan] DisplayDuration 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 [ContentType] Type of one or more Content instances is not supported by the associated zone structure(s).
    • The [string] StateName of one or more PresentationContent entity-relations exceeds 128 characters.
    • The [string] StateName 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 [string] Name of a PresentationZone structure is not unique within the scope of the Presentation instance.
    • The length of a PresentationZone [string] Name exceeds the limit set on the server side.
    • The specified [string] AutorunVersion 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.

Note

This method cannot be used to update a presentation created in BrightAuthor. The server will return an error immediately if this is attempted.

Required Permissions

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

Parameters
  • [int] presentationId: 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 [int] Id is positive but does not correspond to an existing Presentation instance, the server will return a descriptive error.
  • [PresentationZone] entity: A PresentationZone structure with an initialized [int] Id 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 [int] Id does not match an existing PresentationZone structure.
    • The length of the PresentationZone [string] Name exceeds the limit defined on the server side.
    • The PresentationZone [string] Name is not unique within the scope of the account.
    • The [int] AudioVolume or [int] VideoVolume 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
  • [int[]] presentationsIds: 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 [int] Id 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.


  • No labels