1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/hcanyz-ZJsBridge

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
readme-jssdk-api.md 11 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 29.11.2024 16:35 094fb14

zfjs-sdk说明文档

目录

1. 概述

1.1. jssdk使用步骤

1.1.1. 引入js

1.2. 接口调用说明

1.3. 如何判断是否运行在zfjsapp环境中

2. 基础接口

2.1. check

2.2. Контейнер后台前台切换

3. 工具类接口

3.1. 设置浏览器标题文字

3.2. Возврат к предыдущей h5 странице — выход из контейнера при переходе на корневую страницу

3.3. Выход из контейнера

3.4. Сохранение пары ключ-значение — сохранение

3.5. Сохранение пары ключ-значение — чтение

4. Интерфейс класса изображений

4.1. Выбор изображения

4.2. Загрузка изображения

4.3. Предварительный просмотр изображения

5. Видео класс интерфейса

5.1. Выбор видео

5.2. Загрузка видео

5.3. Предварительный просмотр видео

6. Файл класса интерфейса

6.1. Выберите файл

6.2. Загрузить файл

6.3. Предварительный просмотр файла

7. Позиция класса интерфейса

7.1. Выбрать местоположение с помощью интерфейса

7.2. Непосредственно получить местоположение

7.3. Открыть предварительный просмотр карты

概述

jssdk использование шагов

Введение js

В страницу, где требуется вызвать JS-интерфейс, необходимо включить файл JavaScript zfjs-sdk.js.
Поддерживаются методы загрузки стандартных модулей AMD/CMD.

Интерфейс вызова инструкции

Все интерфейсы вызываются через объект zfApi. Параметры представляют собой объект, который включает в себя следующие общие параметры помимо параметров, необходимых для каждого интерфейса:

  • success: функция обратного вызова, которая выполняется при успешном вызове интерфейса.
  • fail: функция обратного вызова, выполняемая при неудачном вызове интерфейса.
  • complete: функция обратного вызова, выполняющаяся после завершения вызова интерфейса, независимо от успеха или неудачи.
  • cancel: функция обратного вызова для отмены операции пользователем, используется только некоторыми API.

Все эти функции имеют один параметр, который является объектом, содержащим данные, возвращаемые каждым интерфейсом, а также некоторые общие атрибуты, такие как: { errCode: 0, errMsg: "" }
где errCode — обязательное поле типа integer, значение которого соответствует ошибке, а errMsg — конкретное описание ошибки при неудачном выполнении.

Как определить, работает ли он в среде zfjsapp

let match = 
navigator.userAgent.match(/zfjs\/(\d+\.\d+\.\d+)/)
||
navigator.userAgent.match(/zfjs\/(\d+\.\d+)/)

let vCode = match && match[1]

Базовый интерфейс

check

Контейнер задний план передний план переключение

window.zfApi.onContainerResume(ret => {
    console.log(`onContainerResume ${JSON.stringify(ret)}`);
});
window.zfApi.onContainerPause(ret => {
    console.log(`onContainerPause ${JSON.stringify(ret)}`);
});

Инструмент класса интерфейса

Установка заголовка браузера

zfApi.setTitle({
    title: "test title" //заголовок
});

Возврат к предыдущему h5 страница — выход из контейнера на корневой странице

zfApi.backCloseWindow({});

Выход из контейнера

zfApi.closeWindow({});

Сохранение пары ключ-значение — сохранение

TODO безопасность

zfApi.putLocalStorageKV({
    key:""      //ключ
    value:""    //значение
});

Сохранение пары ключ-значение — чтение

TODO безопасность

zfApi.getLocalStorageKV({
    key:"",             //ключ
    success(ret){
        let ret.value   //полученное значение
    }
});

Интерфейс класса изображения

Выбор изображения

zfApi.choosePhotos({
    enableCount: 3, //можно выбрать количество, 0<enableCount<=9
    success(ret) {
        let result = ret.result; //[{nativeResourceUrl:"",name:"",size:0}]
        result.forEach(element => {
            let nativeResourceUrl = element.nativeResourceUrl; //адрес изображения в локальной файловой системе
            let name = element.name; //имя
            let size = element.size; //размер файла
        });
    }
});

Загрузка изображения

zfApi.uploadPhotos({
    nativeResourceUrls: [""], //choosePhotos получить
    success(ret) {
        let result = ret.result; //[{nativeResourceUrl:"",serverResourceUrl:""}]
        result.forEach(element => {
            let nativeResourceUrl = element.nativeResourceUrl; //локальный адрес
            let serverResourceUrl = element.serverResourceUrl; //URL сервера
        });
    }
});

Предварительный просмотр изображения

zfApi.previewPhotos({
    urls: ["", ""], //может быть nativeResourceUrl
    index: 0, //отображаемое изображение при открытии
    success() {}
});

Видео класс интерфейса

Выбрать видео

zfApi.chooseVideos({
    enableCount: 3, //количество выбора, 0<enableCount<=3
    success(ret) {
        let result = ret.result; //[{nativeResourceUrl:"",name:"",size:0}]  
        result.forEach(element => {
            let nativeResourceUrl = element.nativeResourceUrl; //локальный адрес
            let name = element.name; //название
            let size = element.size; //размер файла
            let videoTime = element.videoTime; //длительность видео, миллисекунды
        });
    }
});

Загрузить видео

zfApi.uploadVideos({
    nativeResourceUrls: [""], //выбрать видео
    success(ret) {
        let result = ret.result; //[{nativeResourceUrl:"",serverResourceUrl:""}]
        result.forEach(element => {
            let nativeResourceUrl = element.nativeResourceUrl; //локальный адрес
            let serverResourceUrl = element.serverResourceUrl; //сервер URL
        });
    }
});

Просмотр видео

zfApi.previewVideo({
    url: "", //может быть nativeResourceUrl
    success() {}
});

Файл класса интерфейса

Выберите файл

zfApi.chooseFile({
    enableCount: 3,

``` **Загрузить файл**

zfApi.uploadFile({ nativeResourceUrls: [""], //chooseVideos获取到的 success(ret) { let result = ret.result; //[{nativeResourceUrl:"",serverResourceUrl:""}] result.forEach(element => { let nativeResourceUrl = element.nativeResourceUrl; //本地地址 let serverResourceUrl = element.serverResourceUrl; //服务器地址 }); } });


**Предварительный просмотр файла**

zfApi.previewFile({ url: "", //можно указать nativeResourceUrl success() {} });


## Интерфейсы, связанные с местоположением

**Выбрать местоположение через интерфейс**

zfApi.chooseLocation({ success(ret) { let address = ret.address; // подробный адрес let latitude = ret.latitude; // широта, число с плавающей точкой, диапазон от 90 до -90 let longitude = ret.longitude; // долгота, число с плавающей точкой, диапазон от 180 до -180. } });


**Получить текущее местоположение напрямую**

zfApi.getLocation({ success(ret) { let address = ret.address; // подробный адрес let latitude = ret.latitude; // широта, число с плавающей точкой, диапазон от 90 до -90 let longitude = ret.longitude; // долгота, число с плавающей точкой, диапазон от 180 до -180. } });


**Открыть предварительный просмотр карты**

TODO

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/hcanyz-ZJsBridge.git
git@api.gitlife.ru:oschina-mirror/hcanyz-ZJsBridge.git
oschina-mirror
hcanyz-ZJsBridge
hcanyz-ZJsBridge
master