1DOC3 SDK para iOS ObjC

• Bienvenido al SDK para iOS de 1DOC3. Este repositorio contiene el SDK para que terceros consuman los servicios ofrecidos por 1DOC3.

Requirements

• En el archivo Podfile ubicado en la carpeta del proyecto copie y pegue las siguientes lineas de codigo al final.

    post_install do |installer|
            installer.pods_project.targets.each do |target|
                    target.build_configurations.each do |config|
                            config.build_settings['SWIFT_VERSION'] = '4.0'
                    end
            end
    end
  

• Otorga los siguientes permisos en el archivo info.plist

    Privacy - Microphone Usage Description
    Privacy - Camera Usage Description
  

Ejemplo

• Ingrese por consola a la carpeta que contiene su proyecto Objective C y digite pod init.

    pod init
  

• En la arpeta de su proyecto se creo un archivo Podfile habralo con un editor de texto.

• Elimine el # que se encuentra al comienzo de use_frameworks!

    use_frameworks!
  

• Escribe dentro del target del proyecto pod 'Sdk1doc3ObjC'

    target 'ExampleProject' do
        pod 'Sdk1doc3ObjC'
    end
  

• Regrese a la consola y ejecute el comando pod install

• Cuando termine todo el proceso de instalación del pod dirigete a la carpeta del proyecto y habre el archivo .xcworkspace

• Una vez tengas habierto el Xcode busca la clase donde quieras implementar nuestro pod y importala en el .h

    @import Sdk1doc3ObjC;
  

• Delega el protocolo de control de errores al controlador

    @interface Sdk1doc3DemoViewController : UIViewController<Sdk1doc3Delegate>
  

• Habre la clase de implementación del controlador .m

• En el metodo viewDidLoad inicializamos la libreria con los siguientes parametros:

    - (NSString) appId:Identificador de la aplicación;
    - (NSdictionary) metaData: Discionario con informacion del usuario.
  
        -key:@"nombre" value:@"samuel romero"
        -key:@"cedula" value:@123456789
  

• Ejemplo

    [Sdk1doc3 initialize:@"da7920b49c460bf404812acb3a1bf4af945806fb" metaData:@{@"nombre": @"Pablo Neruda",@"cedula": @1234567} completionHandler:^(NSError *error) {
  
        if (!error){
  
            Sdk1doc3PropertiesSingleton *properties = [Sdk1doc3PropertiesSingleton shareManager];
            properties.title = @"DR Romero";
            [Sdk1doc3 startChat:self metaData:@{}];
        }
  
    }];
  

• Despues de inicializar la libreria este metodo respondera a través de un bloque que podra controlar errores en la inicialización.

• En caso de no recibir ningun error usted tendra la posibilidad de modificar propiedades y estilos del chat a través de la clase Sdk1doc3PropertiesSingleton.

    - UIColor *colorBoxSent;
    - UIColor *colorBoxReceived;
    - UIColor *colorTextSent;
    - UIColor *colorTextReceived;
    - UIColor *colorTitle;
    - UIColor *colorLegend;
    - UIColor *colorBar;
    - UIColor *colorIcon;
    - NSString *title;
  

Ejemplo

    Sdk1doc3PropertiesSingleton *properties = [Sdk1doc3PropertiesSingleton shareManager];
    properties.title = @"DR Romero";

• Luego de customizar las propiedades y estilos debe presentar el chat a través de la metodo startChat, este requiere de dos parametros:

    - (UIViewController) viewController: controlador desde el cual llama la libreria.
    - (NSDictionary) metaData: vacio.
  

Ejemplo

[Sdk1doc3 startChat:self metaData:@{}];

• Implementa el metodo onChatErrorStatus que sera llamado por el protocolo de control de errores.

    - (void)onChatErrorStatus:(int)status message:(NSString*)message{
  
            switch (status) {
                case INIT_STATUS:
                //ERRORES SERVICIO INICIO DEL SDK
                break;
  
                case START_STATUS:
                //ERRORES SERVICIO COMENSAR A CHATEAR
                break;
  
                case UPDATE_STATUS:
                //ERRORES SERVICIO DE CARGA DE MENSAJES DEL CHAT
                break;
  
                default:
                break;
            }
    }
  

Installation

Sdk1doc3ObjC is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Sdk1doc3ObjC'

Author

samueldeveloperios, [email protected]

License

Sdk1doc3ObjC is available under the MIT license. See the LICENSE file for more info.