alibaba-cloud-sdk-go/services/rtc/start_task.go

//Licensed under the Apache License, Version 2.0 (the "License");
//you may not use this file except in compliance with the License.
//You may obtain a copy of the License at
//
//http://www.apache.org/licenses/LICENSE-2.0
//
//Unless required by applicable law or agreed to in writing, software
//distributed under the License is distributed on an "AS IS" BASIS,
//WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//See the License for the specific language governing permissions and
//limitations under the License.
//
// Code generated by Alibaba Cloud SDK Code Generator.
// Changes may cause incorrect behavior and will be lost if the code is regenerated.

package rtc

import (
	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/responses"
)

// StartTask invokes the rtc.StartTask API synchronously
// api document: https://help.aliyun.com/api/rtc/starttask.html
func (client *Client) StartTask(request *StartTaskRequest) (response *StartTaskResponse, err error) {
	response = CreateStartTaskResponse()
	err = client.DoAction(request, response)
	return
}

// StartTaskWithChan invokes the rtc.StartTask API asynchronously
// api document: https://help.aliyun.com/api/rtc/starttask.html
// asynchronous document: https://help.aliyun.com/document_detail/66220.html
func (client *Client) StartTaskWithChan(request *StartTaskRequest) (<-chan *StartTaskResponse, <-chan error) {
	responseChan := make(chan *StartTaskResponse, 1)
	errChan := make(chan error, 1)
	err := client.AddAsyncTask(func() {
		defer close(responseChan)
		defer close(errChan)
		response, err := client.StartTask(request)
		if err != nil {
			errChan <- err
		} else {
			responseChan <- response
		}
	})
	if err != nil {
		errChan <- err
		close(responseChan)
		close(errChan)
	}
	return responseChan, errChan
}

// StartTaskWithCallback invokes the rtc.StartTask API asynchronously
// api document: https://help.aliyun.com/api/rtc/starttask.html
// asynchronous document: https://help.aliyun.com/document_detail/66220.html
func (client *Client) StartTaskWithCallback(request *StartTaskRequest, callback func(response *StartTaskResponse, err error)) <-chan int {
	result := make(chan int, 1)
	err := client.AddAsyncTask(func() {
		var response *StartTaskResponse
		var err error
		defer close(result)
		response, err = client.StartTask(request)
		callback(response, err)
		result <- 1
	})
	if err != nil {
		defer close(result)
		callback(nil, err)
		result <- 0
	}
	return result
}

// StartTaskRequest is the request struct for api StartTask
type StartTaskRequest struct {
	*requests.RpcRequest
	OwnerId         requests.Integer      `position:"Query" name:"OwnerId"`
	AppId           string                `position:"Query" name:"AppId"`
	ChannelId       string                `position:"Query" name:"ChannelId"`
	TaskId          string                `position:"Query" name:"TaskId"`
	MediaEncode     requests.Integer      `position:"Query" name:"MediaEncode"`
	BackgroundColor requests.Integer      `position:"Query" name:"BackgroundColor"`
	LayoutIds       []string              `position:"Query" name:"LayoutIds" type:"Repeated"`
	UserPanes       *[]StartTaskUserPanes `position:"Query" name:"UserPanes" type:"Repeated"`
	StreamURL       string                `position:"Query" name:"StreamURL"`
}

type StartTaskUserPanes struct {
	PaneId     requests.Integer `name:"PaneId"`
	UserId     string           `name:"UserId"`
	SourceType string           `name:"SourceType"`
}

// StartTaskResponse is the response struct for api StartTask
type StartTaskResponse struct {
	*responses.BaseResponse
	RequestId string `json:"RequestId" xml:"RequestId"`
}

// CreateStartTaskRequest creates a request to invoke StartTask API
func CreateStartTaskRequest() (request *StartTaskRequest) {
	request = &StartTaskRequest{
		RpcRequest: &requests.RpcRequest{},
	}
	request.InitWithApiInfo("rtc", "2018-01-11", "StartTask", "rtc", "openAPI")
	return
}

// CreateStartTaskResponse creates a response to parse from StartTask response
func CreateStartTaskResponse() (response *StartTaskResponse) {
	response = &StartTaskResponse{
		BaseResponse: &responses.BaseResponse{},
	}
	return
}