nugu_player.h

Go to the documentation of this file.

/*
 * Copyright (c) 2019 SK Telecom Co., Ltd. All rights reserved.
 *
 * 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.
 */
 
#ifndef __NUGU_PLAYER_H__
#define __NUGU_PLAYER_H__
 
#include <nugu.h>
#include <base/nugu_audio.h>
#include <base/nugu_media.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct _nugu_player NuguPlayer;
 
typedef struct _nugu_player_driver NuguPlayerDriver;
 
NUGU_API NuguPlayer *nugu_player_new(const char *name,
                                     NuguPlayerDriver *driver);
 
NUGU_API void nugu_player_free(NuguPlayer *player);
 
NUGU_API int nugu_player_add(NuguPlayer *player);
 
NUGU_API int nugu_player_remove(NuguPlayer *player);
 
NUGU_API NuguPlayer *nugu_player_find(const char *name);
 
NUGU_API int nugu_player_set_audio_attribute(NuguPlayer *player,
                                             NuguAudioAttribute attr);
 
NUGU_API int nugu_player_get_audio_attribute(NuguPlayer *player);
 
NUGU_API const char *nugu_player_get_audio_attribute_str(NuguPlayer *player);
 
NUGU_API int nugu_player_set_source(NuguPlayer *player, const char *url);
 
NUGU_API int nugu_player_start(NuguPlayer *player);
 
NUGU_API int nugu_player_stop(NuguPlayer *player);
 
NUGU_API int nugu_player_pause(NuguPlayer *player);
 
NUGU_API int nugu_player_resume(NuguPlayer *player);
 
NUGU_API int nugu_player_seek(NuguPlayer *player, int sec);
 
NUGU_API int nugu_player_set_volume(NuguPlayer *player, int vol);
 
NUGU_API int nugu_player_get_volume(NuguPlayer *player);
 
NUGU_API int nugu_player_get_duration(NuguPlayer *player);
 
NUGU_API int nugu_player_set_position(NuguPlayer *player, int position);
 
NUGU_API int nugu_player_get_position(NuguPlayer *player);
 
NUGU_API enum nugu_media_status nugu_player_get_status(NuguPlayer *player);
 
NUGU_API void nugu_player_set_status_callback(NuguPlayer *player,
                                              NuguMediaStatusCallback cb,
                                              void *userdata);
 
NUGU_API void nugu_player_emit_status(NuguPlayer *player,
                                      enum nugu_media_status status);
 
NUGU_API void nugu_player_set_event_callback(NuguPlayer *player,
                                             NuguMediaEventCallback cb,
                                             void *userdata);
 
NUGU_API void nugu_player_emit_event(NuguPlayer *player,
                                     enum nugu_media_event event);
 
NUGU_API int nugu_player_set_driver_data(NuguPlayer *player, void *data);
 
NUGU_API void *nugu_player_get_driver_data(NuguPlayer *player);
 
struct nugu_player_driver_ops {
        int (*create)(NuguPlayerDriver *driver, NuguPlayer *player);
 
        void (*destroy)(NuguPlayerDriver *driver, NuguPlayer *player);
 
        int (*set_source)(NuguPlayerDriver *driver, NuguPlayer *player,
                          const char *url);
 
        int (*start)(NuguPlayerDriver *driver, NuguPlayer *player);
 
        int (*stop)(NuguPlayerDriver *driver, NuguPlayer *player);
 
        int (*pause)(NuguPlayerDriver *driver, NuguPlayer *player);
 
        int (*resume)(NuguPlayerDriver *driver, NuguPlayer *player);
 
        int (*seek)(NuguPlayerDriver *driver, NuguPlayer *player, int sec);
 
        int (*set_volume)(NuguPlayerDriver *driver, NuguPlayer *player,
                          int vol);
 
        int (*get_duration)(NuguPlayerDriver *driver, NuguPlayer *player);
 
        int (*get_position)(NuguPlayerDriver *driver, NuguPlayer *player);
};
 
NUGU_API NuguPlayerDriver *
nugu_player_driver_new(const char *name, struct nugu_player_driver_ops *ops);
 
NUGU_API int nugu_player_driver_free(NuguPlayerDriver *driver);
 
NUGU_API int nugu_player_driver_register(NuguPlayerDriver *driver);
 
NUGU_API int nugu_player_driver_remove(NuguPlayerDriver *driver);
 
NUGU_API int nugu_player_driver_set_default(NuguPlayerDriver *driver);
 
NUGU_API NuguPlayerDriver *nugu_player_driver_get_default(void);
 
NUGU_API NuguPlayerDriver *nugu_player_driver_find(const char *name);
 
#ifdef __cplusplus
}
#endif
 
#endif