@tv2media/server-core-integration
v46.3.0
Published
Library for connecting to Core
Downloads
35
Readme
Sofie: The Modern TV News Studio Automation System (Server Core Integration)
This library is used to connect to the Sofie Server Core from other Node processes.
This is a part of the Sofie TV News Studio Automation System.
Note: This library does not follow semver. It is recommended to add it in your package json like "@sofie-automation/server-core-integration": "~1.16.0"
matching the version of sofie core you are running
Getting started
Typescript
import { CoreConnection, PeripheralDeviceAPI } from '@sofie-automation/server-core-integration'
// Set up our basic credentials:
let core = new CoreConnection({
deviceId: 'device01', // Unique id
deviceToken: 'mySecretToken', // secret token, used to authenticate this device
deviceType: PeripheralDeviceAPI.DeviceType.PLAYOUT,
deviceName: 'My peripheral device',
})
core.on('error', console.log)
// Initiate connection to Core:
core
.init({
host: '127.0.0.1',
port: 3000,
})
.then(() => {
// Connection has been established
console.log('Connected!')
// Set device status:
return core.setStatus({
statusCode: PeripheralDeviceAPI.StatusCode.GOOD,
messages: ['Everything is awesome!'],
})
})
.catch((err) => {
console.log(err)
})
Development
This library is developed as part of Sofie Server Core. See there for more instructions
- Build
- Build,
yarn build
- Run tests,
yarn test
- Run tests & watch,
yarn watch
- Build,
DDP Client
This library has a self-contained DDP client that can be used independently of the rest of the module.
import { DDPClient, DDPConnectorOptions } from 'tv-automation-server-integration'
let options: DDPConnectorOptions = {
host: '127.0.0.1',
port: 5432
}
let ddp = new DDPClient(options)
ddp.on('connected', /* ... */ )
ddp.connect((err: any) => {
if (err) {
/* ... handle error ... */
return
}
let subId = ddp.subscribe('expectedMediaItems')
ddp.observe('expectedMediaItems', /* added cb */, /* changed cb */, /* removed cb */)
/* ... then later ... */
ddp.unsub(subId)
ddp.close()
})
See the documentation on the DDP client class for more details.