A Real-Time Pop Server compatible with Broadsign Player.

https://docs.broadsign.com/broadsign-control/13-2/real-time-pop-api.html

6 Commits

1 Branches

0 Publicaties

Alexandre Leblanc 4c33b3ad88 Create rust.yml		5 jaren geleden
.github	4c33b3ad88 Create rust.yml	5 jaren geleden
doc	048ef6f361 update: Add pseudo check for authentication with api key.	5 jaren geleden
src	3486771b49 Update README.md and formatting.	5 jaren geleden
.gitignore	b30ef2f137 feature: Add real sqlite backend to persist the pops.	5 jaren geleden
Cargo.lock	b30ef2f137 feature: Add real sqlite backend to persist the pops.	5 jaren geleden
Cargo.toml	b30ef2f137 feature: Add real sqlite backend to persist the pops.	5 jaren geleden
LICENSE.md	1d90a082b3 update: Improve comments and documentation.	5 jaren geleden
README.md	3486771b49 Update README.md and formatting.	5 jaren geleden

Broadsign Real-Time Pop server sample

This is an unofficial server example. It is discouraged to use it as-is for production uses. It comes with no warranty.

About Real-Time Pop server implementation

This is an implementation of version Broadsign Control 13.2's real-time pop protocol: https://docs.broadsign.com/broadsign-control/13-2/real-time-pop-api.html

Installing Rust

Follow the steps indicated on the official page: https://www.rust-lang.org/tools/install

Using VS Code

Install rust-analyzer and Rust extensions.
Recommended: Change Rust extension settings to use rust-analyzer instead of rls (ctrl + ,).
Run unit tests using cargo test.
Run using cargo run. Use cargo run --release for optimizations.

Log levels

You may set the log level by prepending RUST_LOG=<level>, where level corresponds to:

debug
error
warn
info (default)
trace
```
RUST_LOG=trace cargo run
```
Note that logs messages are not currently enabled in the tests by lack of time and will.

Using Insomnia

An Insomnia file is available (api_insomnia.json). You may import it to help you debug or comprehend how to use this real-time pop server implementation.

Request Json format

{
   "api_key": "{{ api_key }}",
   "player_id": 12345,
	"pop": [
  	{
      "display_unit_id": 4456,
      "frame_id": 4457,
      "n_screens": 1,
      "ad_copy_id": 5001,
      "campaign_id": 5002,
      "schedule_id": 5003,
      "impressions": 2,
      "interactions": 0,
      "end_time": "2016-05-31T10:14:50.200",
      "duration": 5000,
      "ext1": "bmb",
      "ext2": "3451",
      "extra_data": ""
    },
    {
      "display_unit_id": 3456,
      "frame_id": 3457,
      "n_screens": 1,
      "ad_copy_id": 7001,
      "campaign_id": 7002,
      "schedule_id": 7003,
      "impressions": 4,
      "interactions": 1,
      "end_time": "2016-05-31T10:14:55.200",
      "duration": 5000,
      "ext1": "",
      "ext2": "",
      "extra_data": ""
     }
	]
}

License

MIT Licensed. See LICENSE.md

README.md