Устанавливает, должно ли устройство проверять SSL-сертификат при создании защищенного соединения. Если сервер, к которому вы подключаетесь, использует самозаверяющий сертификат, вам нужно будет установить его равным 0, иначе соединение не удастся. Во всех остальных случаях вы должны оставить это значение равным 1, чтобы обеспечить безопасное соединение с сервером. Отключение проверки отключит защиту от атак man in the middle на SSL-соединения.
void agk::SetHTTPVerifyCertificate( UINT iHTTP, int mode )iHTTP - Идентификатор устанавливаемого соединения.
mode - 1 для проверки, 0 для не проверки.Устанавливает время в миллисекундах, в течение которого AGK будет ждать установления соединения, прежде чем отказаться от него.
void agk::SetHTTPTimeout( UINT iHTTP, int milliseconds )iHTTP - Идентификатор устанавливаемого соединения.
milliseconds - Время ожидания в миллисекундах.Задает домен хоста, к которому вы хотите подключиться, например для доступа www.thegamecreators.com/index.php вы бы использовали значение хоста www.thegamecreators.com, не включайте http:, который обычно идет перед ним. Обратите внимание, что попытка использовать определенный порт с www.thegamecreators.com:8080 на некоторых платформах это может быть проигнорировано, и в этих случаях будет использоваться порт 80. При экспорте в HTML5 обратите внимание, что веб-браузеры ограничивают количество серверов, к которым вы можете подключиться. По умолчанию вы ограничены файлами, размещенными на том же сервере, что и ваше приложение. Однако если сервер отправляет заголовок Access-Control-Allow-Origin в своем ответе, который разрешает сервер вашего приложения, то браузер позволит вам подключиться к нему.
UINT agk::SetHTTPHost( UINT iHTTP, const char *szHost, int iSecure )
UINT agk::SetHTTPHost( UINT iHTTP, const char *szHost, int iSecure, const char *szUser, const char *szPass )iHTTP - Идентификатор устанавливаемого соединения.
szHost - Домен для подключения.
iSecure - Установите значение 1, чтобы использовать защищенное соединение HTTPS, и 0, чтобы использовать стандартное соединение HTTP.
szUser - Имя пользователя для отправки на сервер.
szPass - Пароль для отправки на сервер.Отправьте запрос на сервер, указанный в SetHTTPHost, например, если запрашивается http: www.thegamecreators.com/index.php szServerFile должен быть index.php. Эта команда немедленно возвращается и ждет ответа сервера в фоновом режиме. Вы можете проверить статус ответа с помощью GetHTTPResponseReady и, когда он будет готов, получить ответ с помощью GetHTTPResponse.
int agk::SendHTTPRequestASync( UINT iHTTP, const char *szServerFile )
int agk::SendHTTPRequestASync( UINT iHTTP, const char *szServerFile, const char *szPostData )iHTTP - Идентификатор используемого соединения.
szServerFile - Файл, который нужно запросить с сервера, включает в себя все, что находится после доменной части URL-адреса.
szPostData - Необработанные данные post для отправки на сервер обратите внимание, что & и = - это специальные символы, разделяющие переменные.Отправьте запрос на сервер, указанный в SetHTTPHost (), например, если запрашивается http: www.thegamecreators.com/index.php szServerFile должен быть index.php. Эта команда ожидает ответа сервера и возвращает ответ сервера. Если вы используете уровень 2, вы должны удалить этот ответ, когда закончите с ним. Не работает при экспорте в HTML5
char* agk::SendHTTPRequest( UINT iHTTP, const char *szServerFile )
char* agk::SendHTTPRequest( UINT iHTTP, const char *szServerFile, const char *szPostData )iHTTP - Идентификатор используемого соединения.
szServerFile - Файл, который нужно запросить с сервера, включает в себя все, что находится после доменной части URL-адреса.
szPostData - Необработанные данные post для отправки на сервер обратите внимание, что & и = - это специальные символы, разделяющие переменные.Отправьте файл на сервер, указанный в SetHTTPHost, например, если запрашивается http: www.thegamecreators.com/index.php szServerFile должен быть index.php. Также позволяет отправлять POST-данные на сервер, которые могут включать переменные или файловые данные, например myvar=5&var2=test. Эта команда немедленно возвращается и ждет ответа сервера в фоновом режиме. Вы можете проверить статус ответа с помощью GetHTTPResponseReady и, когда он будет готов, получить ответ с помощью GetHTTPResponse. Вы можете проверить ход загрузки с помощью GetHTTPFileProgress. Не работает при экспорте в HTML5
int agk::SendHTTPFile( UINT iHTTP, const char *szServerFile, const char *szPostData, const char *szLocalFile )iHTTP - Идентификатор используемого соединения.
szServerFile - Файл, который нужно запросить с сервера, включает в себя все, что находится после доменной части URL-адреса.
szPostData - Необработанные данные post для отправки на сервер обратите внимание, что & и = - это специальные символы, разделяющие переменные.
szLocalFile - Имя файла, который вы хотите отправить на сервер.Удаляет заголовок, который вы ранее добавили, если вы не использовали AddHTTPHeader для добавления заголовка с заданным именем, то эта команда ничего не делает. Если имя заголовка является стандартным заголовком, который обычно включается, то эта команда не удаляет его, а вместо этого использует AddHTTPHeader с пустой строкой, чтобы перезаписать его. Если имя заголовка является стандартным заголовком, который вы перезаписали, то эта команда возвращает его к нормальному значению. Обратите внимание, что эта команда не работает в версии HTML5.
void agk::RemoveHTTPHeader( UINT iHTTP, const char* headerName )iHTTP - Идентификатор соединения для изменения.
headerName - Имя заголовка для удаленияОткрывает браузер по умолчанию текущей платформы и указывает его на заданную страницу.
void agk::OpenBrowser( const char *url )url - URL - адрес для открытияКодирует строку таким образом, чтобы она могла быть отправлена на сервер по протоколу HTTP без вмешательства в HTTP-запрос. Например, если вы хотите отправить переменную POST, содержащую символы & или=, они будут выглядеть как дополнительные переменные внутри строки, которую вы хотите отправить. Использование HTTPEncode в этой строке превратит эти символы в ПОСТ-безопасные значения, которые затем автоматически преобразуются обратно в исходные символы, как только они достигнут чего-то вроде PHP-скрипта. При этом используется стандартная кодировка URL-адреса для не буквенно-цифровых символов, оставляя только буквенно-цифровые символы.
char* agk::HTTPEncode( const char* str )str - Строка для кодированияДекодирует строку, закодированную URL-адресом. Он может декодировать все буквенно-цифровые символы и большинство не буквенно-цифровых символов.
char* agk::HTTPDecode( const char* str )str - Строка для декодированияВозвращает 1, если устройство подключено к Интернету, и 0, если нет.
int agk::GetInternetState()Возвращает код состояния, который был возвращен с сервера в ответе. Вы должны дождаться, пока GetHTTPResponseReady вернет ненулевое значение, прежде чем проверять эту команду, иначе она вернет 0. Обычно код состояния равен 200, когда запрос был успешным
int agk::GetHTTPStatusCode( UINT iHTTP )iHTTP - Идентификатор соединения для проверки.Возвращает 1, если запрос, ранее отправленный с помощью SendHTTPRequestASync, завершен. Вы можете получить ответ с помощью GetHTTPResponse. Возвращает 0, если запрос все еще выполняется, или -1, если запрос не удался.
int agk::GetHTTPResponseReady( UINT iHTTP )iHTTP - Идентификатор соединения для проверки.Возвращает 1, если загрузка файла, ранее начатая с помощью GetHTTPFile, завершена, в противном случае-0. Даже если это возвращает 1, чтобы сказать, что загрузка завершена, возможно, она не удалась, проверьте GetHTTPResponseReady на наличие отрицательных значений, прежде чем предполагать, что загрузка прошла успешно.
int agk::GetHTTPFileComplete( UINT iHTTP )iHTTP - Идентификатор соединения для проверки.Возвращает ход загрузки файла в виде плавающего значения от 0 до 100. Это не следует полагаться на то, чтобы работать, когда загрузка закончена, и на некоторых платформах может не дать точного представления о ходе загрузки. Используйте GetHTTPFileComplete или GetHTTPResponseReady, чтобы определить, завершена ли загрузка.
float agk::GetHTTPFileProgress( UINT iHTTP )iHTTP - Идентификатор соединения для проверки.Загружает HTTP - файл с сервера, указанного в SetHTTPHost, и сохраняет его в указанном месте. Также позволяет отправлять POST-данные на сервер, которые могут включать переменные или файловые данные, например myvar=5&var2=test. Эта команда немедленно возвращается и продолжает загрузку файла в фоновом режиме. Вы можете проверить ход загрузки с помощью GetHTTPFileProgress и GetHTTPFileComplete. Затем файл будет находиться в указанном вами месте, готовый к использованию с AGK.
int agk::GetHTTPFile( UINT iHTTP, const char *szServerFile, const char *szLocalFile, const char *szPostData )
int agk::GetHTTPFile( UINT iHTTP, const char *szServerFile, const char *szLocalFile )iHTTP - Идентификатор используемого соединения.
szServerFile - Файл, который нужно запросить с сервера, включает в себя все, что находится после доменной части URL-адреса.
szLocalFile - Место для сохранения в файл, это будет внутри папки записи для текущего устройства.
szPostData - Необработанные данные post для отправки на сервер обратите внимание, что & и = - это специальные символы, разделяющие переменные.Возвращает ответ с сервера на предыдущий отправленный запрос SendHTTPRequestASync. Вы должны дождаться, пока GetHTTPResponseReady вернет 1, прежде чем вызывать эту команду. В tier 2 вы должны удалить возвращаемую строку с помощью agk::DeleteString, когда закончите ее использовать. Уровень 2 имеет дополнительную команду GetHTTPResponseReadyC, которая возвращает const char, который не нуждается в удалении.
char* agk::GetHTTPResponse( UINT iHTTP )iHTTP - Идентификатор соединения для проверки.Удаляет ранее созданное HTTP-соединение.
void agk::DeleteHTTPConnection( UINT iHTTP )iHTTP - Идентификатор соединения для удаления.Создает HTTP - соединение, готовое к использованию позже. Возвращает идентификатор, используемый для ссылки на него позже.
UINT agk::CreateHTTPConnection()Закрывает соединение с сервером, дальнейшие соединения могут быть созданы, если вы снова вызовете SetHTTPHost.
void agk::CloseHTTPConnection( UINT iHTTP )iHTTP - Идентификатор соединения для закрытия.Добавляет указанный заголовок ко всем будущим запросам. Если заголовок уже существует, то его значение будет перезаписано новым значением. Если заголовок является стандартным заголовком, который обычно присутствует, то его значение будет перезаписано значением, которое вы даете. Если заголовок является стандартным заголовком, который обычно присутствует, а значение, которое вы даете, является пустой строкой, то стандартный заголовок будет удален. Не добавляйте двоеточие ни в одно из полей, оно будет добавлено автоматически между ними. Обратите внимание, что эта команда не работает в версии HTML5.
void agk::AddHTTPHeader( UINT iHTTP, const char* headerName, const char* headerValue )iHTTP - Идентификатор соединения для изменения.
headerName - Имя устанавливаемого заголовка, например Content-Type
headerValue - Новое значение для заголовка