Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
...
| borderColor | #3D3D3D |
|---|---|
| bgColor | #F4F4F4 |
| titleColor | #3D3D3D |
| borderWidth | 0 |
| titleBGColor | #3D3D3D |
| borderStyle | solid |
ON THIS PAGE
...
Presentation Entity
The Presentation entities has the following properties:
...
Idint
...
:(read only) The identifier and primary key of the Presentation instance.
...
Namestring
...
: The user-defined name of the Presentation instance. This string value must be unique in the scope of the BrightSign Network account.
...
CreationDateDateTime
...
:(read only) A UTC timestamp indicating when the presentation was created within the BrightSign Network.
...
LastModifiedDateDateTime
...
:(read only) A UTC timestamp indicating the last time that presentation was modified.
...
AutorunVersionstring
...
:(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.
...
LanguagePresentationLanguage
...
: A PresentationLanguage enumeration that represents the target language of the presentation. This property currently has no effect on the operation of a presentation.
...
ZonesList<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.
...
GroupsGroupInfo[]
...
:(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.TD1012AU320HD210HD1010LS322LS422HD920HD970HD220HD1020HD922HD972HD222HD1022XD230XD1030XD1230XD232XD1032XD11324K2424K10424K1142
DeviceFamily Enumeration
The DeviceFamily enumeration can contain the following values:
UnknownMonaco: HD210, HD1010, HD1010w, TD1012Leopard: LS322, LS422Panther: HD220, HD1020, AU320Bobcat: HD222, HD1022Cheetah: XD230, XD1030, XD1230Lynx: XD232, XD1032, XD1132Tiger: 4K242, 4K1042, 4K1142Puma: HD970
PresentationLanguage Enumeration
The PresentationLanguage enumeration can contain the following values:
Unknown: This property is used by the server for presentations created in BrightAuthor.EnglishFrenchItalianGermanSpanishSwedish
ScreenSettings Structure
The ScreenSettings structure has the following properties:
...
VideoMode
...
VideoMode: A VideoMode enumeration representing the resolution of a Presentation entity.
...
BackgroundColorstring
...
: 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”)
...
OrientationScreenOrientation
...
: A ScreenOrientation enumeration, which can contain the following values:
LandscapePortrait
...
ConnectorConnectorType
...
: A ConnectorType enumeration, which can contain the following values:
VGAHDMIComponent
...
OverscanScreenOverscan
...
: A ScreenOverscan enumeration, which can contain the following values:
NoOverscanOverscanActionSafeAreaOverscanTitleSafeArea
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:
...
Idint
...
: The identifier and primary key of the zone.
...
Namestring
...
: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
...
Xint
...
: The x-axis coordinate specifying left side of the zone.
...
Yint
...
: The y-axis coordinate specifying the top of the zone.
...
Widthint
...
: The horizontal size of the zone.
...
Heightint
...
: The vertical size of the zone.
...
ContentsList<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:
...
Idint
...
: The identifier and primary key of the zone.
...
IsFrontbool
...
: A flag indicating whether this zone is in front of another Video Only zone or Video or Images zone.
...
Idint
...
: The identifier and primary key of the zone.
...
Namestring
...
: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
...
Xint
...
: The x-axis coordinate specifying left side of the zone.
...
Yint
...
: The y-axis coordinate specifying the top of the zone.
...
Widthint
...
: The horizontal size of the zone.
...
Heightint
...
: 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.
...
AnalogOutputAnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
...
AnalogOutput2AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
...
AnalogOutput3AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
...
HDMIOutputHDMIOutputMode
...
: An HDMIOutputMode enumerationspecifying the transmission setting of the HDMI output on the device.
...
SPDIFOutputSPDIFOutputMode
...
: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
...
USBOutputUSBOutputMode
...
: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
...
AudioMixingAudioMixingType
...
: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
...
VideoVolumeint
...
: The volume of the video file track, represented as an integer between 0 and 100.
...
AudioVolumeint
...
: The volume of the audio file track, represented as an integer between 0 and 100.
...
ContentsList<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:
...
Idint
...
: The identifier and primary key of the zone.
...
Namestring
...
: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
...
Xint
...
: The x-axis coordinate specifying left side of the zone.
...
Yint
...
: The y-axis coordinate specifying the top of the zone.
...
Widthint
...
: The horizontal size of the zone.
...
Heightint: The vertical size of the zone.
...
ImageMode
...
ImageMode: An ImageMode enumeration specifying how the image(s) will fill the zone.
...
ContentsList<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:
...
Idint
...
: The identifier and primary key of the zone.
...
Namestring
...
: The user-defined name of the zone. This name of a presentation zone must be unique within the scope of a presentation.
...
Xint
...
: The x-axis coordinate specifying left side of the zone.
...
Yint
...
: The y-axis coordinate specifying the top of the zone.
...
Widthint
...
: The horizontal size of the zone.
...
Heightint
...
: The vertical size of the zone.
...
ContentsList<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:
...
IsFrontbool
...
: 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.
...
AnalogOutputAnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
...
AnalogOutput2AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
...
AnalogOutput3AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
...
HDMIOutputHDMIOutputMode
...
: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.
...
SPDIFOutputSPDIFOutputMode
...
: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
...
USBOutputUSBOutputMode
...
: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
...
AudioMixingAudioMixingType
...
: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
...
VideoVolumeint
...
: The volume of the video file track, represented as an integer between 0 and 100.
...
AudioVolumeint
...
: 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.
...
AnalogOutputAnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
...
AnalogOutput2AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
...
AnalogOutput3AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
...
HDMIOutputHDMIOutputMode: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.
...
SPDIFOutputSPDIFOutputMode
...
: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
...
USBOutputUSBOutputMode
...
: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
...
AudioMixingAudioMixingType
...
: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
...
AudioVolumeint
...
: 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:
...
FadeLengthint
...
: 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.
...
AnalogOutputAnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of the 3.5mm audio output on the device.
...
AnalogOutput2AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a second 3.5mm audio output on the device.
...
AnalogOutput3AnalogOutputMode
...
: An AnalogOutputMode enumeration specifying the transmission setting of a third 3.5mm audio output on the device.
...
HDMIOutputHDMIOutputMode
...
: An HDMIOutputMode enumeration specifying the transmission setting of the HDMI output on the device.
...
SPDIFOutputSPDIFOutputMode
...
: A SPDIFOutputMode enumeration specifying the transmission setting of the SPDIF port on the device.
...
USBOutputUSBOutputMode
...
: A USBOutputMode enumeration specifying the audio transmission setting of the USB port(s) on the device.
...
AudioMixingAudioMixingType
...
: An AudioMixingType enumeration specifying the audio-mixing setting of all audio outputs.
...
AudioVolumeint
...
: 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:
ScaleToFillLetterboxedAndCenteredFillScreenAndCentered
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:
CenterImageScaleToFitScaleToFillAndCropScaleToFill
AnalogOutputMode Enumeration
The AnalogOutputMode enumeration represents the options for transmitting audio over the 3.5mm output on the device. It has the following values:
NonePCMMultichannel
HDMIOutputMode Enumeration
The HDMIOutputMode enumeration represents the options for transmitting audio over the HDMI® output on the device. It has the following values:
NonePCMPassThrough
SPDIFOutputMode Enumeration
The SPDIFOutputMode enumeration represents the options for outputting audio over the SPDIF port on the device. It has the following values:
NonePCMPassThrough
USBOutputMode Enumeration
The USBOutputMode enumeration represents the options for transmitting audio over the USB port(s) on the device. It has the following values:
NonePCMSurround
AudioMixingType Enumeration
The AudioMixingType enumeration represents the options for mixing all audio. This setting affects all video outputs. It can contain the following values:
StereoLeftRight
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.
4096x2160x24p3840x2160x60p3840x2160x59.94p3840x2160x50p3840x2160x30p3840x2160x29.97p3840x2160x25p3840x2160x24p1920x1200x60p1920x1080x60p1920x1080x59.94p1920x1080x50p1920x1080x30p1920x1080x29.97p1920x1080x25p1920x1080x24p1920x1080x60i1920x1080x59.94i1920x1080x50i1680x1050x60p1600x1200x60p1440x900x75p1440x900x60p1400x1050x75p1400x1050x60p1360x768x60p1280x1024x75p1280x1024x60p1280x960x60p1280x800x75p1280x800x60p1280x768x60p1280x720x60p1280x720x59.94p1280x720x50p1024x768x75p1024x768x60p960x960x60p800x600x75p800x600x60p720x576x50p720x480x60p720x480x59.94p640x480x60pSECAMNTSC-COMPONENTPAL-COMPONENTNTSC-MNTSC-M-JPNPAL-IPAL-BGPAL-NPAL-NCPAL-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:
...
Idint
...
: The identifier and primary key of the parent Group instance
...
Namestring
...
: 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.
...
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
...
markerstring
...
: The
...
Namestring of the last Presentation instance on the previous page. If the value is Null, then the method will retrieve the first page.
...
pageSizeint: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the
...
pageSizeint
...
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.
...
| title | 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
...
presentationIdsint[]
...
: An array of
...
Idint 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.
...
| title | 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
...
namePatternstring
...
: The exact
...
Namestring of the Presentation instance (or its wildcard-based pattern). Supported wildcards currently include “*”, “?”, and “[‘and’]”.
...
markerstring
...
: The
...
Namestring of the last Presentation instance on the previous page. If the value is Null, then the method will retrieve the first page.
...
pageSizeint
...
: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the
...
pageSizeint
...
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.
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
...
presentationIdint
...
: The identifier and primary key of the Presentation instance to be retrieved.
...
loadContentbool
...
: 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
Truewill 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.
...
| title | 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
...
namestring
...
: The user-defined Name of the Presentation instance to be retrieved.
...
loadContentbool
...
: 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
...
deviceModelDeviceModel
...
: 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
...
namestring
...
: 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
...
presentationIdint
...
: The identifier and primary key of the Presentation instance to evaluate. If a Presentation instance with the specified
...
Idint
...
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
...
Namestring
...
,
...
DeviceModel
...
DeviceModel,
...
ScreenSettings
...
ScreenSettings, and
...
ZonesList<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
...
Namestring is greater than 100 characters.The Presentation
...
Namestring 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
...
Xint
...
,
...
Yint
...
,
...
Widthint
...
, and
...
Heightint properties—exceeds the boundaries of the screen as defined by the
...
VideoMode
...
VideoMode
...
property of the ScreenSettings structure.
The
...
IsFrontbool property is set to True for more than one VideoPresentationZone or VideoOrImagesPresentationZone structure.The
...
DisplayDurationTimeSpan of a PresentationContent entity-relation representing an image is less than 1 second or greater than 24 hours.The
...
DisplayDurationTimeSpan of a PresentationContent entity-relation representing a web page is less than 0 seconds or greater than 24 hours.The
...
FadeLengthint
...
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
...
TypeContentType of one or more Content instances is not supported by the associated zone structure(s).The
...
StateNamestring of one or more PresentationContent entity-relations exceeds 128 characters.The
...
StateNamestring 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
...
Idint
...
of a zone structure is not unique within the scope of the Presentation instance.
The
...
Namestring of a zone structure is not unique within the scope of the Presentation instance.The length of a zone
...
Namestring exceeds 50 characters.The length of a PresentationZone
...
Namestring exceeds the limit defined on the server.The specified
...
AutorunVersionstring 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().
...
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
...
entityPresentation
...
: 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
...
Idint
...
does not correspond to an existing Presentation instance.
The
...
Idint
...
of one or more zone structures does not correspond to a preexisting zone in the Presentation instance.
The length of the Presentation
...
Namestring exceeds the 256 character limit.The Presentation
...
Namestring is already in use by an existing Presentation instance.The length of a zone structure
...
Namestring exceeds the 50 character limit.A specified zone structure
...
Namestring 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
...
FadeLengthint
...
value of an EnhancedAudioPresentationZone structure is greater than 100 or less than zero.
The boundaries of a zone structure—as defined by its
...
Xint
...
,
...
Yint
...
,
...
Widthint
...
, and
...
Heightint
...
properties—exceeds the boundaries of the screen as defined by the [VideoMode] VideoMode property of the ScreenSettings structure.
The
...
IsFrontbool property is set to True for more than one VideoPresentationZone or VideoOrImagesPresentationZone structure.The
...
DisplayDurationTimeSpan of a PresentationContent entity-relation representing an image is less than 1 second or greater than 24 hours.The
...
DisplayDurationTimeSpan 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
...
TypeContentType of one or more Content instances is not supported by the associated zone structure(s).The
...
StateNamestring of one or more PresentationContent entity-relations exceeds 128 characters.The
...
StateNamestring 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
...
Namestring of a PresentationZone structure is not unique within the scope of the Presentation instance.The length of a PresentationZone
...
Namestring exceeds the limit set on the server side.The specified
...
AutorunVersionstring 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.
...
...
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
...
presentationIdint
...
: 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
...
Idint
...
is positive but does not correspond to an existing Presentation instance, the server will return a descriptive error.
...
entityPresentationZone
...
: A PresentationZone structure with an initialized
...
Idint
...
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
...
Idint does not match an existing PresentationZone structure.The length of the PresentationZone
...
Namestring exceeds the limit defined on the server side.The PresentationZone
...
Namestring 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
...
presentationsIdsint[]
...
: 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
...
Idint
...
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.
| Panel | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
ON THIS PAGE
|