Sound Control Protocol for SpeechLine Digital Wireless

SSC Developer‘s guide for SpeechLine Digital Wireless | 91/109
SSC Method List (CHG 2N/CHG 4N)
14.11 /osc/state/subscribe
Parameter type: N.A.
Permission: N.A.
Pre-condition: N.A.
Post-condition: N.A.
Description: A subscription request is sent by a client to a server for an address pattern to subscribe
to. The SSC Server normally accepts the subscription request, and remembers that the requesting
client wishes to be notified about value changes of the subscribed addresses. Without a lifetime val-
ue (unit is seconds), the default lifetime for a subscription to be active is 10 seconds.
Example 1 – with default parameter (CHG 2N):
TX: {"osc":{"xid":1234567890,"state":{"subscribe":[{"bays":{"active":
null}}]}}}
RX: {"osc":{"xid":1234567890},"osc":{"state":{"subscribe":[{"bays":
{"active":[false,false]}}]}}}
RX: {"bays":{"active":[false,false]}
subscription terminates after 10 seconds with:
RX: {"osc":{"error":[{"bays":{"active":[310]}}]}}
Example 1 – with default parameter (CHG 4N):
TX: {"osc":{"xid":1234567890,"state":{"subscribe":[{"bays":{"active":
null}}]}}}
RX: {"osc":{"xid":1234567890},"osc":{"state":{"subscribe":[{"bays":
{"active":[false,false,false,false]}}]}}}
RX: {"bays":{"active":[false,false,false,false]}
subscription terminates after 10 seconds with:
RX: {"osc":{"error":[{"bays":{"active":[310]}}]}}
Example 2 – with non-default parameter (CHG 2N):
TX: {"osc":{"state":{"subscribe":[{"#":{"lifetime":2000},"bays":
{"active":null}}]}}}
RX: {"osc":{"state":{"subscribe":[{"#":{"lifetime":2000},"bays":
{"active":[false,false]}}]}}}
RX: {"bays":{"active":[false,false]}
Parameter value changes:
RX: {"bays":{"active":[true,false]}}
RX: {"bays":{"active":[true,true]}}
RX: {"bays":{"active":[false,true]}}
RX: {"bays":{"active":[false,false]}}
subscription terminates at end of subscription lifetime with:
RX: {"osc":{"error":[{"bays":{"active":[310]}}]}}
Example 2 – with non-default parameter (CHG 4N):
TX: {"osc":{"state":{"subscribe":[{"#":{"lifetime":2000},"bays":
{"active":null}}]}}}
RX: {"osc":{"state":{"subscribe":[{"#":{"lifetime":2000},"bays":
{"active":[false,false,false,false]}}]}}}
RX: {"bays":{"active":[false,false,false,false]}