{"type":"doc","content":[{"type":"paragraph","content":[{"text":"As of BrightSignOS 8.2.10, the ","type":"text"},{"text":"syncmanager ","type":"text","marks":[{"type":"em"}]},{"text":"object provides synchronization capabilities for video walls and other deployments that require closely calibrated interaction among players. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"syncmanager IDL","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"[\n constructor(String networkInterface, String domain, String multicast_address, unsigned multicast_port)\n] interface SyncManager {\n attribute boolean leader;\n attribute String networkInterface;\n readonly attribute String domain;\n attribute boolean encrypted;\n attribute boolean encryptionKeyIsObfuscated;\n writeonly attribute String encryptionKey;\n void synchronize(in String id, in unsigned long ms_delay);\n void close()\n};","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Object Creation","type":"text"}]},{"type":"paragraph","content":[{"text":"To create an ","type":"text"},{"text":"syncmanager","type":"text","marks":[{"type":"em"}]},{"text":" object, first load the ","type":"text"},{"text":"brightsign/syncmanager","type":"text","marks":[{"type":"code"}]},{"text":" module using the ","type":"text"},{"text":"require()","type":"text","marks":[{"type":"code"}]},{"text":" method. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"const BSSyncManager = require(\"@brightsign/syncmanager\");\nlet sm = new BSSyncManager(network_interface, domain, multicast_address, multicast_port);","type":"text"}]},{"type":"paragraph","content":[{"text":"The constructor for a sync manager object takes four arguments:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"network_interface","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The network interface (for example, \"eth0\")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"domain","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The domain identifier used to distinguish among different ","type":"text"},{"text":"roSyncManager","type":"text","marks":[{"type":"em"}]},{"text":" instances.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"multicast_address","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The multicast address to which synchronization messages are communicated.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"multicast_port","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"int","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": The multicast port to which synchronization messages are communicated.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SyncManager","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"synchronize()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"void synchronize(in String id, in unsigned long ms_delay)","type":"text"}]},{"type":"paragraph","content":[{"text":"Broadcasts a time-stamped message to other players. This method is used on the leader unit only. The message will be rebroadcasted every second to allow follower units that are powered on late to catch up. The network message contains the sync ID, as well as the domain and a timestamp. The timestamp is created at the point when this method is called; however, it can be offset by passing a non-zero ","type":"text"},{"text":"ms_delay","type":"text","marks":[{"type":"code"}]},{"text":" value, allowing synchronization points to be set slightly in the future and giving the client enough time to switch video files and perform other actions. The ","type":"text"},{"text":"identifier","type":"text","marks":[{"type":"code"}]},{"text":" parameter allows the script on the leader unit to pass a filename, or some other useful marker, to the follower units as part of the synchronization message. This method returns the message that is sent out so that the leader can access the timestamp. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The synchronization message is sent over all available networks (including WiFi), but follower units will use only the first message received.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Because synchronization can involve follower units seeking to catch up with the playback of a leader unit, we recommend using the more efficient MOV/MP4 container format when synchronizing video files. Transport Stream files (MPEG-TS) are also supported, but they must begin with a presentation timestamp (PTS) of 0. Program Stream files (MPEG-PS) are not supported.","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"close()","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"void close()","type":"text"}]},{"type":"paragraph","content":[{"text":"Shuts down the instance, freeing the underlying sync manager. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SyncManager Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"leader","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"boolean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A read/write boolean attribute to set/get whether the sync manager is a leader, or a follower.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"networkInterface","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A read/write string attribute to set/get which network interface the sync manager uses (for example, ","type":"text"},{"text":"\"eth0\"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"\"wifi0\"","type":"text","marks":[{"type":"code"}]},{"text":"). The networkInterface parameter can be \"\" to allow any network interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"domain","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"boolean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A read-only string attribute which returns the domain for the sync manager","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"encrypted","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"encryptionKey","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"encryptionKeyIsObfuscated","type":"text","marks":[{"type":"code"}]},{"text":" are used to configure the use of encryption with the sync manager:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"encrypted","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"boolean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A read/write attribute that controls whether the sync manager uses encryption: If ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", encryption is enabled on the unit. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"encryptionKeyIsObfuscated","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"boolean","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A write-only string attribute which is used to set the key used for encryption. Contact ","type":"text"},{"text":"support@brightsign.biz","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:support@brightsign.biz"}}]},{"text":" to learn more about generating a key for obfuscation and storing it on the player.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"encryptionKey","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": A write-only string attribute which is used to set the key used for encryption","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"This HTML code lets you listen for sync messages using ","type":"text"},{"text":"syncmanager","type":"text","marks":[{"type":"em"}]},{"text":": ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"\n\n\n\n>/head>>\n\n

syncmanager Test Page

\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}