Use offsetms on media query

[avraham1]

I want to play media to the client from a certain point in time. But I can't play media with offsetms.

func playLesson(ctx context.Context, h *ari.ChannelHandle, lessonKey string, offsetms string) { h.Play("", "sound:path/to/file?offsetms=" + offsetms) }

How do you do that? Thanks in advance

[Ulexus]

It looks like we need to add support for something like PlayOptions; we don't expose that right now. It shouldn't be too disruptive to just tack a PlayOptions... to the end of the channel (and bridge) Play functions and interfaces.

[avraham1]

Thank you.

Do you have an estimate of when you will be able to add it?

[Ulexus]

No, but PRs are always welcome.

[Ulexus]

Also we do offer consulting and programming services, if you wish.

[serfreeman1337]

I'm sorry that I'm completely forgot about additional params in https://github.com/CyCoreSystems/ari/pull/142. Before api get tagged, what about changing it from variadic function to interface instead ?

Play(key *Key, playbackID string, opts interface{}) (*PlaybackHandle, error)

type PlaybackOptions struct {
	// Media URIs to play.
	Media []string `json:"media"`

	// For sounds, selects language for sound.
	Lang string `json:"lang,omitempty"`

	// Number of milliseconds to skip before playing. Only applies to the first URI if multiple media URIs are specified.
	OffsetMs int `json:"offsetms,omitempty"`

	// Number of milliseconds to skip for forward/reverse operations.
	SkipMs int `json:"skipms,omitempty"`
}

// StagePlay stages a `Play` operation on the bridge
func (c *Channel) StagePlay(key *ari.Key, playbackID string, opts interface{}) (*ari.PlaybackHandle, error) {
	if playbackID == "" {
		playbackID = rid.New(rid.Playback)
	}

	resp := make(map[string]interface{})

	var req interface{}

	switch v := opts.(type) {
	case string:
		req = struct {
			Media string `json:"media"`
		}{
			Media: v,
		}
	case ari.PlaybackOptions:
		req = v
	}

	playbackKey := c.client.stamp(ari.NewKey(ari.PlaybackKey, playbackID))

	return ari.NewPlaybackHandle(playbackKey, c.client.Playback(), func(pb *ari.PlaybackHandle) error {
		return c.client.post("/channels/"+key.ID+"/play/"+playbackID, &resp, &req)
	}), nil
}

This way will keep backward compatibility with v5 api:

 // v5 api (will be still valid with v6)
h.Play("myPlaybackID", "sound:hello-world")

// v6 api
h.Play("myPlaybackID", ari.PlaybackOptions{
	Media: []string{"hello-world"}, 
	Lang: "en", 
	OffsetMs: 750,
})
h.Play("myPlaybackID", ari.PlaybackOptions{
	Media: []string{"sound:your", "sound:extension", "sound:number", "sound:is", "digits:123"}, 
})